NBStatues - PureForge 1.16.5 - Version 2022.09.a

PureForge 1.16.5 mod allowing the creation of events of hunting for presents, statues, monsters and even pokemon (if Pixelmon is installed). You can also script events like maps / event adventures, quests and stories to tell. An advanced configuration easily and quickly done in-Game.

What is a "Collection" in NBStatues?

A collection is a container that contains a list of objects to find, that can be Blocks, Entities, Monster, TileEntities, NPC and Pokemon (Statue or EntityPixelmon). To claim an object, player must right click on it.

Configuration

This category explains how to set up and use NBStatues. No dependency required. Some features are unlocked if you have Pixelmon installed. Very fast installation, in 5 minutes you've the time to create a really complete collection.

This product uses NBAuth, guaranteeing you increased security, access to APIs, better stability and instant startup.

Permissions

To configure this mod, users must have OP permission for single player instances, for servers, users will need the "nbstatues.admin" permission to configure the mod.

Players must have permission "nbstatues.base" to see UI. You can also define permission for each collection you create, to see and complete it, players must have theses permissions.

Reward commands syntax

You've two type of commands:

• Commands starting with "/": The command will be executed by the player
  • Example: "/nbstatues Halloween" will open the Halloween collection for the player.
• Commands starting with "!": The command will be executed by the server
  • Example: "!give {PLAYER} minecraft:diamond 6" Will give 6 diamond to the player.
• Commands starting with "PM": Send a private message to the player
  • Example: "PM &aYou should go to the mansion to find this &6artefact&a." Will send the message below in green and yellow to the player.
• Commands starting with "BROAD": Will send a message to all player online on the server
  • Example: "BROAD &2Someone found the secret ofthe haunted pumpkin and earns the rank "&6Master of Halloween 2021&2". " All player will see this message in the chat.
• Commands equal "CLOSE": Force the UI to be close for the player

The placeholder {PLAYER} is available and will be replaced by the name of the player.

Configuration files

Configuration files are JSON files. If you've any problems with the plugin, please look the error displayed and test your config file on one online JSON verifier (for example: https://jsonformatter.curiousconcept.com/) to found the issue easily, if you don't found the problems, please open a ticket in my discord and attach config file, errors and an message of what that have happens.

You've 5 configurations (you can edit it to customize, but the default configuration is nice to start):

• Messages.json : All strings, text and format of the plugin for your player.
• General.json : Main configuration of the plugin (World exclusion, Commands alias, and Logs display)
• License.json : All information about your license, please don't share your personal file, else the license will be disabled by the security system.
• StatuesCollection.json : All collections data are available here. You can customize format, commands, icons, and object directly here, but you've automatic commands to do theses changes without any risk of problems if you write something wrong.
• PlayerData folder : Folder who contains the progress of each player, to remove the progress of one player delete the file with his UUID name.

I recommend you to only customize Messages.json and General.json in a first time because commands are easier.

Placeholder, formats and features for collections

*"<>" means that is required, and "{}" optional, if the content of "{}" is in upper case it's variable data*

This configuration is automatically made if you make your collection in game, but it's really good to know.

Bloc arguments:

• Structure: <modid:item_name> or PRESENT<{NBT_Tag}>
• Example:
  • minecraft:blue_carpet
    • (Blue carpet)
  • pixelmon:poke_ball
    • (Pixelmon Pokéball)
  • PRESENT{SkullOwner:&quot;NicolasBrg&quot;}
    • (NicolasBrg's Head)
  • PRESENT{SkullOwner: "MHF_Present2"}
    • (Present)

For custom skull, you can see the official list of included MHF skull https://minecraft.fandom.com/wiki/Head or use custom from online website like: https://minecraft-heads.com/player-heads or https://minecraft-heads.com/custom-heads (Please note that for custom heads, you need to use nbt from 1.15.5 version, a wiki is also available, be very careful that the format doesn't break the config by escaping ")

Pokémon arguments:

• Structure: <PokemonSpecies {Pixelmon Specs}
• Example:
  • Turtwig (Turtwig icon)
  • Giratina form:alternative shiny (Shiny Giratina alternative form)

For more example and information, follow, official documentation: https://pixelmonmod.com/wiki/Pokemon_spec (Please take notes, that Pokémon have priority on Bloc)

Description arguments:

• Structure: <description> (You can use "\n" to back to the line, and "&" to add color)
• Alias available (Collection only):
  • {CURRENT} Number of statues found in the collection
  • {MAX} Number of statues in the collection
• Example:
  • &2First Line\n&aSecond Line
  • &6{CURRENT}&e/&6{MAX}&b statues

Commands arguments:

• Command_List: Display all commands attached to the statues or collection
• Command_Add <Command> Add a new command
• Command_Remove_Id <ID> Remove command from ID (starting to 0)

Commands

Here is a list of commands available in NBStatues. For each commands you have tab assistance. Keep in mind you can configure the plugin without all theses commands, with UI. See video above or wiki page.

/nbstatues_admin <Action>

• Config
  • Load Load all config files
  • Save Save collections file
  • Refresh _String Reload all strings from Messages.json
• Collection
  • List
    • Display the list of all collection. (Click on an item to edit the collection)
  • Info
    • Display if you're currently editing one collection.
  • Save
    • Save the collection and leave the editor mod.
  • Create < Name >
    • Create a new collection
  • Edit < Name >
    • (REQUIRED FOR COMMANDS BELOW) Edit one collection
  • Rename < NewName >
    • Rename the selected collection.
  • Print
    • Display all statues from a collection
  • Permission < Permission >
    • Define a new permission for the selected collection
  • Remove < Name >
    • Remove the collection (You need to have selected it before with edit command)
  • Pokemon < PokemonArg >
    • Define pokemon icon (see format above)
  • Bloc < BlockArg >
    • Define block icon (see format above)
  • Display_Name < Name >
    • Define a new display name to the collection (with color code "&")
  • Description < Content >
    • Description with line break and color (see format above)
  • Delete_statue < ID >
    • Delete the statue from ID (format of name is WORLD/PosX/PosY/PosZ tab will auto complete it for you, you've also the UI to remove statues without this command; to delete a statue, you need to edit the statue's collection.
  • Refresh_collection
    • Refresh collections and statues from config.
  • Command_List
    • Display list of commands after collection completion
  • Command_Add < Value >
    • Add new command after collection completion
  • Command_Remove_Id** < ID >
    • Delete command n°ID of commands after collection completion
  • sort_by_icons
    • Sorts the statues by appearance for the selected collection.
• Statues <Statue> <Action> (theses commands have the same format that showed above)
  • Name <Value>
  • Description {Value}
  • Bloc <Value>
  • Pokemon <Value>
  • Command_List
  • Command_Add <Value>
  • Command_Remove_Id <ID>
  • StartTime <Value>
  • EndTime <Value>
  • Help
• Help : Display help

/nbstatues {Action}

• " CollectionName": Display UI of the "CollectionName" collection
  • If a player have the admin permission, he can right clicked on one statue in UI to delete it.
• NicolasBrg : Send dev information
• If empty : Open Main UI of collection

Take note that UI who display all statue have page system.

/nbstatues_force <StatueID> {Player}

Force a claim of the selected statue to the player.