NIA Server Documentation

website·Indexed 31 days ago

https://docs.mcnia.com/

Documentation for a cross-platform Minecraft Bedrock server based on official BDS. It includes a play guide for vanilla survival expansion, server history, and developer guides for NIAHttpBOT and various systems such as Shop, Land, Task, PlayerTitle, and Market. The technical stack features NiaServer-Core and NiaServer-Extra, with specific tutorials for plugins like KillItem and Ntrade.

Tokens
15.5K
Snippets
56
Records
94
Agent score
49%

What's inside NIA Server

  1. Overview of NIAHttpBOT

    NIAHttpBOT is a C++ based bot system designed as a sub-project of NiaServer-Core. It overcomes the limitations of the Minecraft Bedrock Edition (BDS) Script-api (such as the inability to perform file read/write operations) by providing an HTTP-based interface. Key features include file system management (read, write, create, delete) and integration with QQ bots using NapCatQQ.
  2. Overview of Cross-Platform Minecraft Server Support

    The server is based on the official Bedrock Dedicated Server (BDS), enabling cross-platform play across Android, iOS, and Windows. It is designed to update in sync with official Minecraft Bedrock Edition releases to ensure the latest game experience.
  3. Overview of Cross-Platform Server capabilities

    The Cross-Platform Server is built on the official Bedrock Dedicated Server (BDS), enabling compatibility across all platforms where Minecraft Bedrock Edition is available, including Android, iOS, and Windows. The server is designed to update in sync with the official Minecraft version to ensure the latest gaming experience.
  4. Ntrade maintenance status and replacement

    Ntrade is no longer maintained and does not receive technical support. It has been replaced by market.js within the script-api-based plugin NiaServer-Core.
  5. NIA Server General Principles

    The NIA server is a Bedrock Edition server powered by the BDS core. It is a non-profit (public welfare) server that accepts only selfless donations and guarantees there will be no paid items or monetization projects. The community structure consists of administrators, player assistants, and ordinary players.
  6. Install and initialize the KillItem plugin

    The KillItem plugin is used to periodically clean up server drops and provides a mechanism to backtrack and recover cleared items. To install it:

    1. Configure your Bedrock Dedicated Server (BDS) and install LiteLoader.
    2. Download the latest version of KillItem.
    3. Place KillItem.js from the extracted package into the plugins folder within the BDS root directory.
    4. Launch bedrock_server_mod.exe to automatically generate the plugin's configuration file.
  7. Define title properties and unlock requirements

    Titles are configured using a JSON object. Key properties include:

    • title: The display text or icon of the title.
    • tag: A unique identifier for the title.
    • type: The type of title, such as text or image.
    • can_buy / show_in_shop: Boolean flags to determine if the title is purchasable and visible in the shop.
    • price: The cost to purchase the title.
    • description: A user-facing description of the title.
    • check_mode: Determines how requirements are evaluated. Options include and (all must be met), or (any must be met), or none (no requirements).
    • check: An array of requirement objects. Each requirement contains:
      • type: The type of check, such as tag (checks player tags) or scoreboard (checks a scoreboard value).
      • operator: The comparison operator (e.g., ==, >=, <=).
      • value: The value to compare against.
      • scoreboard: (For scoreboard types) The name of the scoreboard to check.
      • scoreboard_show_name: (For scoreboard types) The display name of the scoreboard.
    {
        "title_money_10000": {
            "title": "§b家财万贯",
            "tag": "title_money_10000",
            "type": "text",
            "can_buy": true,
            "show_in_shop": true,
            "price": 0,
            "description": "金币达到10000",
            "check_mode": "and",
            "check": [
                {
                    "type": "scoreboard",
                    "scoreboard": "money",
                    "scoreboard_show_name": "金币",
                    "operator": ">=",
                    "value": 10000
                }
            ]
        }
    }
  8. Join the required community groups for server access

    To play on the server, you must join the official community groups. Failure to do so will prevent you from playing. If the verification group link fails, contact the server owner via QQ.

    Official Groups:

    • Main Group: 724360499
    • Verification Group: 371417932
    • Backup Group: 258515673
    • Admin Recruitment Group: 543363488
    • Server Owner QQ: 1020317403
  9. Connect to the Minecraft server

    To join the server, navigate to the main menu: Game -> Servers -> Add Server. Enter the IP address and port provided in the official QQ group announcement. The server name can be anything you choose.
  10. Install Minecraft Bedrock Edition

    The server requires the Bedrock Edition of Minecraft. Unless otherwise specified, the server runs on the latest official stable release. It can be downloaded from the Microsoft Store (Windows 10), App Store (iOS), or Google Play (Android).