OmniEssentiels — All-in-One Plugin for Paper

Grades, tags, tabs/nametags, economy, shop, GUI menus, levels, daily quests, homes, spawn, lobby mode. Everything is configured in config.yml.

1. Install on [your server]

1. [Your server]’s control panel: Paper server.
2. File manager / FTP: place the .jar file in the plugins/ folder.
3. Restart the server. config.yml is created in plugins/[YourServer]/.
4. Grant yourself admin rank: from the panel console, type op [YourUsername] then in-game, type /rank set [YourUsername] admin.

3. Commands

Command	Description	Permission
/menu (or right-click on the star)	Main menu	all
/shop	Shop (left-click to buy, right-click to sell, Shift = x64 / all)	all
/balance [player], /pay <player> <amount>, /baltop	Economy	all
/eco <give|take|set> <player> <amount>	Manage money	myserver.admin
/sethome [name], /home [name], /delhome <name>, /homes	Homes	all
/spawn	Return to spawn	all
/setspawn	Set spawn	[yourserver].admin
/level	Level and XP	all
/quests	Daily quests	all
/tag	Choose / buy a tag	all
/rank list, /rank set <player> <rank>	Ranks	[yourserver].admin
/[yourserver] reload	Reload config	[yourserver].admin

Other permissions: [yourserver].teleport.bypass (no teleport delay), [yourserver].lobby.bypass (bypasses lobby restrictions), [yourserver].tag.founder (example of a reserved tag).

4. Usage by Server Type

• Survival / Economy: Leave the default settings as is; adjust shop prices.
• RPG: Adjust levels (XP, progression curve, rewards) and quests.
• Lobby / hub: lobby.enabled: true, spawn.teleport-on-join: true, use /setspawn where you want to welcome players.
• Minigames: the plugin provides ranks, tabs, economy, menus, and a lobby, but not a minigame engine (arenas, teams, rounds). This must be coded separately, based on this framework.

5. Customization

• Text: MiniMessage format (https://docs.advntr.dev/minimessage/format.html), colors <red>, gradients <gradient:red:gold>text</gradient>, etc.
• Ranks: ranks section (prefix, color, number of hearts, sales bonus).
• Shop: shop.categories section (Minecraft material names in ALL CAPS).
• Menus (icons, positions) are in src/main/java/dev/[yourserver]/gui/.

6. Good to Know

• Player data: plugins/[yourServer]/players/<uuid>.yml (automatically saved every 5 minutes).
• Block XP can be farmed by placing or breaking blocks; quests can be completed this way as well.
• Shop: Max 45 items per category, max 21 categories.
• Homes: Menus display a maximum of 14 homes (the /home <name> command works for all of them).

Translated with DeepL.com (free version)