EssentialsZ

EssentialsZ plugin for the Avrix Loader for Project Zomboid.

📄 About

EssentialsZ is a comprehensive utility plugin for the Avrix Loader, designed to streamline server administration and enhance the multiplayer experience in Project Zomboid.

✅ Requirements

• Project Zomboid 42.20.x+
• Avrix Loader 2.2.x+
• Avrix API 1.0.x+
• Java Development Kit (JDK) 25+

🚀 Installation

1. Download the latest EssentialsZ-<version>.jar file from the Releases page.
2. Open the root directory of your Project Zomboid installation.
3. Create a plugins directory if it does not already exist.
4. Place the downloaded JAR file into the plugins directory.
5. Start Project Zomboid through the Avrix Loader.

💬 Documentation

Command	Permission	Description
/getpos (aliases: pos, coords, where, whereami, vehiclepos)	essentialsz.getpos	Retrieves coordinates of self, an online player, or a vehicle by ID.
/tp (aliases: teleport, tpto, goto)	essentialsz.teleport	Teleports self or players to specific coordinates or other players.
/tpvehicle (aliases: tpveh, movecar, tpc)	essentialsz.movecar	Teleports a vehicle by ID to a player or yourself
/give (aliases: i, item, giveitem, additem)	essentialsz.item.give	Gives items to yourself or another player.
/kill (aliases: slay)	essentialsz.player.kill	Kills the specified player
/suicide (aliases: killme)	essentialsz.player.suicide	Commits suicide (instant death)
/findvehicle (aliases: locatecar, findveh, findcar)	essentialsz.vehicle.find	Finds vehicles around a player or within a specific radius
/perm (aliases: permissions, p, role, roles)	essentialsz.permissions	Manage permissions, roles, capabilities, and player access.
/perm user	essentialsz.permissions.user	Manage per-user permissions, capabilities, and role assignments.
/perm role	essentialsz.permissions.role	Create, delete, and modify role configurations and attributes.
/perm list	essentialsz.permissions.list	List all registered system and custom roles.
/perm reload	essentialsz.permissions.reload	Reload permissions.yml configuration from disk.
/help (aliases: ?, helpme)	essentialsz.help	Displays available server commands or in-depth information about a specific command.
/spawnvehicle (aliases: addvehicle, veh, car, vehicle)	essentialsz.vehicle.spawn	Spawns a vehicle at specific coordinates or near a player.
/inv (aliases: inventory, invsee)	essentialsz.item.inv	Lists all items in your own or another player's inventory.
/delitem (aliases: deleteitem, removeitem, rmitem, destroy)	essentialsz.item.delitem	Deletes items from hands or inventory.
/delitem hand	essentialsz.item.delitem.hand	Delete item in hand: /delitem hand [player] [primary|secondary]
/delitem all	essentialsz.item.delitem.all	Delete all items: /delitem all [player]
/delitem item	essentialsz.item.delitem.item	Delete items by type: /delitem item [player] <type> [count] (0 = all)
/fixitem (aliases: fi, repairitem)	essentialsz.item.fixitem	Repairs items in hands or inventory.
/fixitem hand	essentialsz.item.fixitem.hand	Repair the item in hand: /fixitem hand [player] [primary|secondary]
/fixitem all	essentialsz.item.fixitem.all	Repair all items: /fixitem all [player]
/fixitem item	essentialsz.item.fixitem.item	Repair items by type: /fixitem item [player] <type>

🤝 Contributing

Contributions, bug reports, and suggestions are welcome.

Before opening a pull request:

1. Check the existing issues and pull requests.
2. Describe the purpose of your change.
3. Keep public API changes documented.
4. Verify that the project builds successfully with JDK 25 or higher.

💬 Community

Join the Avrix Discord server to ask questions, discuss development, and share feedback.

⚖️ License

This project is licensed under the MIT License.