Aurus

Aurus is a packet-based 3D menu system for modern Paper servers.

It renders interactive menus directly in front of the player using fake entities and a custom camera, instead of classic chest inventories.

Built for Paper 1.20+, designed to be flexible, animated, and fully configurable through YAML.

How it works

When a menu is opened:

- The player is mounted on an invisible camera entity - Fake entities (text, items, blocks, players, mobs) are spawned via packets — only the viewer can see them - A floating cursor follows the player's head movement - Clicks are detected through packet listening

No inventory windows. No chest GUI. Just world-space menus.

1. Install PacketEvents 2.x on your Paper server.

2. Drop [ICODE]Aurus-1.1.4-BETA.jar[/ICODE] into your [ICODE]plugins/[/ICODE] folder.

3. Start the server — default menus are created in [ICODE]plugins/Aurus/menus/[/ICODE].

4. Open a menu in-game: [ICODE]/au open welcome_server[/ICODE]

```yaml welcome_menu: distance: 2.5 update-in-ticks: 20 on-open: - "[sound] entity.player.levelup, 1.0, 1.5" - "[message] <green>Welcome to the server!" on-close: - "[message] <red>See you later!" components: title: type: TEXT text: "<gold>Welcome, <aqua>%player_name%!" x: 0.0 y: 2.0 size: 2.0 background: false play_btn: type: BUTTON text: "<green>[ Play ]" x: 0.0 y: 0.0 size: 1.5 sound: "ui.button.click" actions: - "[close]" - "[player] spawn" - "[sound] entity.player.levelup, 1.0, 1.2" - "[message] <green>Teleported!" npc: type: PLAYER skin: "Notch" nametag: "<gold>Notch" x: 2.0 y: -0.5 rotation: x: -30 x-head: -45 y-head: 10 ```

Commands

| Command | Description | |---|---| | `/au open <menu_id> [player]` | Opens a menu for yourself or a target player | | `/au close [player]` | Closes the active menu | | `/au reload` | Reloads config and menus | | `/au debug` | Toggles debug mode |

Alias: `/au`

Permissions

| Permission | Description | Default | |---|---|---| | `aurus.admin` | Access to all `/au` subcommands | op |

This plugin is currently in beta. If you find bugs, please open an issue on GitHub or report in the official discord server

~ Fendrixx