NetherGate.API v1.0.5 — nugetz

pkg

virgil698/NetherGate.APIv1.0.5

Name: NetherGate.API
Author: virgil698

.NET 9.0

Plugin API for NetherGate - A Minecraft server management platform. Provides interfaces and models for developing NetherGate plugins.

github.com ↗

License

LGPL-3.0-or-later

Deps

Install Size

—

Vulns

✓ 0

Published

Oct 9, 2025

Get Started

$ dotnet add package NetherGate.API

Readme

NetherGate

🌐 现代化的 .NET Minecraft 服务器插件加载器 🌐

✨ 为什么选择 NetherGate？

🎯 易于使用，功能强大

NetherGate 让插件开发变得简单而强大：

🎨 从入门到精通：无论是简单的签到插件、礼包系统，还是复杂的 QQ 机器人、备份插件、经济插件，都能轻松实现
⚡ 开箱即用：完整的 API 设计，无需学习复杂概念即可上手
🔥 真正的热重载：插件更新无需重启服务器，保留运行状态，支持跨版本迁移
📦 智能依赖管理：自动下载 NuGet 包，智能解决版本冲突，告别依赖地狱
🎭 完全隔离：每个插件独立运行环境，互不干扰，崩溃不影响其他插件

🚀 100% 功能覆盖率

核心能力	状态	说明
SMP 协议	✅ 100%

操作系统	架构	文件名
Windows	x64 (推荐)	`nethergate-nightly-win-x64.zip`
Windows	x86	`nethergate-nightly-win-x86.zip`
Windows	ARM64	`nethergate-nightly-win-arm64.zip`
Linux	x64 (推荐)	`nethergate-nightly-linux-x64.tar.gz`
Linux	ARM	`nethergate-nightly-linux-arm.tar.gz`
Linux	ARM64	`nethergate-nightly-linux-arm64.tar.gz`
macOS	Intel x64	`nethergate-nightly-osx-x64.tar.gz`
macOS	Apple Silicon	`nethergate-nightly-osx-arm64.tar.gz`

git clone https://github.com/your-org/NetherGate.git
cd NetherGate
dotnet build -c Release

cd bin/Release
./NetherGate.Host

./NetherGate.Host --wizard

server_process:
  launch_method: java  # java | script | external
  working_directory: ./
  
  java:
    jar_path: server.jar
    min_memory: 2G
    max_memory: 4G

./NetherGate.Host

dotnet new classlib -n MyPlugin
cd MyPlugin
dotnet add package NetherGate.API

using NetherGate.API.Plugins;
using NetherGate.API.Events;

namespace MyPlugin;

public class MyPlugin : IPlugin
{
    private IPluginContext _context;

    public void OnEnable(IPluginContext context)
    {
        _context = context;
        _context.Logger.Info("MyPlugin 已启用！");
        
        // 订阅玩家加入事件
        _context.EventBus.Subscribe<PlayerJoinedEvent>(OnPlayerJoined);
    }

    private async void OnPlayerJoined(PlayerJoinedEvent e)
    {
        // 发送欢迎消息
        await _context.GameDisplay.SendChatMessageAsync(
            e.PlayerName, 
            $"§a欢迎 {e.PlayerName} 加入服务器！"
        );
    }

    public void OnDisable()
    {
        _context.Logger.Info("MyPlugin 已禁用");
    }
}

dotnet build
# 将生成的 DLL 复制到 plugins/ 目录
# 使用 `plugin load MyPlugin` 命令加载，或重启 NetherGate

// BossBar、Title、ActionBar、聊天消息
await context.GameDisplay.ShowBossBarAsync("my_boss", "欢迎！", 1.0f);
await context.GameDisplay.ShowTitleAsync("@a", "§6标题", "§e副标题");

// NBT 数据（1.20.4-）、数据组件（1.20.5+）
var playerData = await context.PlayerDataReader.ReadPlayerDataAsync(uuid);
await context.NbtDataWriter.UpdatePlayerHealthAsync(uuid, 20.0f);

// 物品组件系统
var item = await context.ItemComponentReader.ReadInventorySlotAsync(player, slot);
await context.ItemComponentWriter.UpdateComponentAsync(player, slot, "custom_name", "神剑");

// 完整的服务器管理
var players = await context.SmpApi.GetPlayersAsync();
await context.SmpApi.AddToAllowlistAsync("Player123");
await context.SmpApi.UpdateGameRuleAsync("doDaylightCycle", "false");

// 执行任意 Minecraft 命令
var result = await context.RconClient.ExecuteCommandAsync("give @a diamond 64");

// 跨插件消息传递（适用于模块化开发）
var response = await context.Messenger.SendMessageAsync(
    "EconomyPlugin", "transfer", 
    new { from = "Player1", to = "Player2", amount = 100 }
);

NetherGate/
├── src/
│   ├── NetherGate.API/          # 插件 API 接口
│   ├── NetherGate.Core/         # 核心实现
│   └── NetherGate.Host/         # 主程序
├── docs/                        # 完整文档
├── scripts/                     # 构建脚本
└── bin/Release/                 # 编译输出
    ├── NetherGate.Host.exe      # 主程序
    ├── plugins/                 # 插件目录
    ├── config/                  # 配置目录
    └── logs/                    # 日志目录

virgil698/NetherGate.APIv1.0.5

Get Started

Readme

NetherGate

✨ 为什么选择 NetherGate？

🎯 易于使用，功能强大

🚀 100% 功能覆盖率

💡 核心优势

🎮 兼容性说明

支持的 Minecraft 版本

支持的服务端类型

📥 快速开始

1. 下载

2. 配置

3. 启动

🔌 5 分钟创建第一个插件

1. 安装 NuGet 包

2. 编写代码

3. 构建并加载

📚 丰富的功能 API

🎮 游戏交互

📦 数据操作

🎯 SMP 协议

🔧 RCON 命令

💬 插件间通信

⚙️ 更多功能

📖 文档导航

🎓 新手入门

📘 核心功能

🔧 插件开发

⚙️ 高级功能

🏗️ 项目架构

🤝 贡献

📄 许可证

💬 社区和支持

🌟 致谢

特别感谢

开源项目