Presents

Description

This side-mod adds special presents to Minecraft that players can find throughout the server. Server owners have the ability to fully customize and place presents by adding new entries to the config.json configuration file. After setting up, they can use the /presents give <identifier> command to get the corresponding present by its identifier.

Presents can be hidden in various locations on the server, creating an exciting treasure hunt for surprises. Players, upon discovering a present, can activate it with a right-click to receive their well-deserved reward!

For administrators, a special feature is available through the /presents command, which opens an interface with all active presents on the server. By clicking on any of them in the menu, the administrator is instantly teleported to its location.

Commands

All commands require permission level 2 or present.admin permission through the LuckPerms system

• /presents - opens the graphical interface with all active presents on the server
• /presents give <identifier> - gives the item that can be placed to create a new present
• /presents reload - reloads the configuration

Menu Item Configuration

Each item in the menu can be configured as follows:

{
  "name": "Menu Item",
  "material": "stone",
  "lore": ["Lore line 1", "Lore line 2"],
  "nbt": "{}",
  "amount": 1
}

Configuration

{
  "messages": {
    "prefix": "<red>[<dark_green>Presents<red>] <dark_gray>»",
    "alreadyFoundPresent": "%prefix% <red>You've already found this present.",
    "foundPresent": "%prefix% You found a present."
  },
  "menu": {
    "closeItem": {
      "name": "<red>Close",
      "material": "barrier"
    },
    "fillItem": {
      "name": "<gray> ",
      "material": "gray_stained_glass_pane"
    },
    "barItem": {
      "name": "<gray> ",
      "material": "black_stained_glass_pane"
    },
    "nextPageItem": {
      "name": "<green>Next",
      "material": "arrow"
    },
    "lastPageItem": {
      "name": "<green>Back",
      "material": "arrow"
    },
    "presentLore": [
      "<green>Dimension: <gray>%dimension%",
      "<green>Location: <gray>%x%</gray>, <gray>%y%</gray>, <gray>%z%</gray>"
    ]
  },
  "presents": [
    {
      "identifier": "christmas",
      "item": {
        "name": "Christmas Present",
        "material": "minecraft:player_head",
        "nbt": "{\"minecraft:profile\":{\"id\":[I;-2002873815,1388858326,-1525192356,172033830],\"name\":\"\",\"properties\":[{\"name\":\"textures\",\"value\":\"eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMmIxZWM3ZGM3NTMwNjFjYTE3NDQyNGVhNDVjZjk0OTBiMzljZDVkY2NhNDc3ZDEzOGE2MDNlNmJlNzU1ZWM3MiJ9fX0=\"}]}}"
      },
      "rewards": [
        "give %player% diamond 1"
      ]
    }
  ]
}