DOCSEARCHbyAlgolia
Submit Docs

SHTechCraft Minecraft Documentation

website·Indexed 30 days ago

https://blog.talexck.com/blog/

Technical documentation for SHTechCraft Minecraft servers, including the collaborative building 'Block Campus' (方块校园) server using the WorldGit plugin, the Survival server running Fabric 26.1.2, and the Bingo event server. It covers server core selection, Java configuration, deployment, permissions, and detailed guides for custom plugins like WorldGit and GameVoting.

Tokens
21.8K
Snippets
91
Records
200
Agent score
50%

What's inside SHTechCraft

  1. Overview of WorldGit Collaborative Building Plugin

    WorldGit is a Minecraft plugin designed for collaborative construction. It adapts Git-style version control concepts—specifically branching, auditing/review, and merging—to Minecraft map editing. This system is used to protect the primary 'main world' while enabling multiple builders to work on different sections or versions of the map in parallel.

  2. Overview of the GameVoting Plugin

    GameVoting is a voting plugin designed for Minigames lobbies. It runs on Paper servers and integrates with CloudNet v4 to launch minigame sub-servers and teleport players who participate in the voting process to the target game server.

  3. Browse All WorldGit Branches

    The 'View All Branches' menu provides a global overview of all existing branches in the system, including the total count, number of unmerged branches, and a paginated list showing owners, tags, status, and region info. Players can left-click any unmerged branch to teleport and preview it; non-members of that branch have read-only access.

  4. Manage the WorldGit build-review-merge workflow

    WorldGit implements a version-control style workflow for Minecraft world editing. The core process consists of: selecting a region, creating a branch for isolated editing, submitting the work for review, and merging the approved changes back into the main world.

  5. SHTechCraft Block Campus Server Specifications

    The SHTechCraft Block Campus server is a Paper-based Minecraft server designed for collaborative building. It uses a 'version-controlled workbench' approach to prevent unauthorized changes to the main world.
    # Key server.properties configuration
server-port=25565
motd=Building SHTech...
online-mode=true
gamemode=creative
difficulty=peaceful
max-players=20
view-distance=16
simulation-distance=10
spawn-protection=0
white-list=false

  6. Install base dependencies for the Survival Server Fabric environment

    The survival server utilizes the Fabric Mod ecosystem. The following base dependencies are required for the server and other mods to function correctly:

    • Fabric API: The fundamental API for the Fabric ecosystem.
    • Cloth Config: A configuration prerequisite for several mods.
    • YetAnotherConfigLib (YACL): A configuration prerequisite for several mods.

  8. Understand WorldGit Main World Protection scope

    WorldGit's Main World Protection is designed to prevent players from bypassing the branch workflow to modify the main world directly. The system intercepts the following actions:

    • Block placement and destruction (including multi-block placement).
    • Axiom block package modifications.
    • Use of water and lava buckets.
    • Bone meal and fertilization.
    • Liquid flow, spreading, decay, and generation.
    • Piston pushing and pulling.
    • Explosions.
    • Hanging entities such as item frames and paintings.
    • Armor stand operations.
    • Spawn eggs.
    • Certain natural and hostile mob spawning.
    • Transitions from the main world into the Nether or the End.

  9. Review Branches as an Administrator

    Users with the worldgit.admin.review permission can access the Review Entry. The system categorizes branches into 'Pending Review' (first-time submissions) and 'Re-review Required' (main line updated since last review).

    Administrator Actions:

    • Teleport to Branch: Inspect the build in its own world.
    • Highlight Changes: Toggle visibility of modified blocks.
    • Approve: Move the branch to the merge confirmation stage.
    • Reject: Provide a reason via a sign and return the branch to the player for edits.

  10. Conclude a Bingo game session

    Follow these steps to properly end a Bingo session:

    1. Confirm final scores/results.
    2. Save the server logs.
    3. Create separate backups of any statistics files.
    4. Shut down the server.
    5. Process and clean up the world directory to prepare for the next round.

  11. Manage WorldGit backups

    WorldGit performs scheduled backups. Success is indicated in the logs by the message: [WorldGit] 世界备份完成: world-YYYYMMDD-HHMMSS. It is recommended to perform a manual backup before executing large-scale merges.
    /wg admin backup

  12. Setup Triton on Ascend NPU (AutoDL)

    To run Triton on Ascend NPUs within an AutoDL environment:

    1. Select a community image containing CANN 8.3 and PyTorch 2.7.1.
    2. Install the triton-ascend package via pip.
    3. Note that standard CUDA benchmarks (e.g., benchmark.py) will not work; you must implement a compatible NPU version (e.g., benchmark_npu.py).
    pip install triton-ascend