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]

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