NetherGate

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

简体中文 | English

✨ 为什么选择 NetherGate？

🎯 易于使用，功能强大

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

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

🚀 100% 功能覆盖率

核心能力	状态	说明
SMP 协议	✅ 100%	35 个方法 + 22 个通知处理
RCON 命令	✅ 100%	完整的游戏命令支持（60+ 命令）
日志监听	✅ 100%	服务器生命周期 + 玩家事件
网络事件	✅ 100%	4 种监听模式（LogBased 立即可用）
NBT 数据	✅ 100%	读取 + 写入（玩家/世界数据）
数据组件	✅ 100%	1.20.5+ 物品组件系统支持
方块数据	✅ 100%	箱子/漏斗/告示牌等容器读写
文件操作	✅ 100%	读写/监听/备份
性能监控	✅ 100%	CPU/内存/TPS
游戏实用工具	✅ 100%	烟花/音乐/时间/区域操作
扩展方法库	✅ 100%	物品堆/位置扩展方法
成就追踪	✅ 100%	实时追踪玩家成就进度
统计分析	✅ 100%	游戏统计/方块收集进度
排行榜系统	✅ 100%	灵活的排行榜管理
数据推送	✅ 100%	WebSocket 实时数据广播

💡 核心优势

⚡ 高性能：原生 .NET 编译，执行效率远超解释型语言
🛡️ 安全隔离：AssemblyLoadContext 机制，插件完全隔离
🎨 现代架构：
- ✅ 依赖注入 (DI)：支持构造函数注入，松耦合设计
- ✅ 异步 API：全异步编程模型，高性能
- ✅ 事件驱动：灵活的事件订阅和发布
- ✅ 连接池：网络连接复用，资源高效利用
- ✅ 分布式支持：跨服务器节点的插件通信
🔥 先进的热重载：
- ✅ 保留插件状态（数据不丢失）
- ✅ 支持代码修改后立即生效
- ✅ 自动卸载旧版本，加载新版本
- ✅ 插件间依赖自动重载
🌐 跨平台：支持 8 种平台架构组合
- Windows: x64, x86, ARM64
- Linux: x64, ARM, ARM64
- macOS: Intel x64, Apple Silicon ARM64
📚 文档完善：覆盖所有功能的中文文档，丰富示例

🎮 兼容性说明

支持的 Minecraft 版本

✅ Java Edition 1.21.9+（及以上版本）

支持的服务端类型

NetherGate 支持所有开放 RCON + SMP 协议的 Minecraft 服务端，包括但不限于：

Vanilla (原版)
Paper
Purpur
Leaves
Leaf
Forge
Fabric
NeoForge

前置要求：

✅ 服务端需开启 RCON 功能（用于命令执行）
✅ 服务端需支持 SMP 协议（用于服务器管理）

📥 快速开始

1. 下载

从 Releases 下载适合您系统的版本：

操作系统	架构	文件名
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

2. 配置

首次运行会自动生成配置文件：

cd bin/Release
./NetherGate.Host

或使用交互式配置向导：

./NetherGate.Host --wizard

配置文件示例： nethergate-config.yaml

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

详细配置： 配置文件详解

3. 启动

./NetherGate.Host

三种启动模式：

Java 模式：NetherGate 直接启动 Minecraft 服务器
Script 模式：使用现有启动脚本
External 模式：连接到已运行的服务器（仅管理功能）

🔌 5 分钟创建第一个插件

1. 安装 NuGet 包

NetherGate.API 发布在 GitHub Packages，安装前需要配置 NuGet 源：

方式一：使用项目配置文件（推荐）

在项目根目录创建 nuget.config：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <add key="github" value="https://nuget.pkg.github.com/virgil698/index.json" />
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
  </packageSources>
</configuration>

然后进行身份验证并安装：

# 配置 GitHub Packages 认证（使用 GitHub Personal Access Token）
dotnet nuget add source --username YOUR_GITHUB_USERNAME --password YOUR_GITHUB_TOKEN --store-password-in-clear-text --name github "https://nuget.pkg.github.com/virgil698/index.json"

# 创建插件项目
dotnet new classlib -n MyPlugin
cd MyPlugin

# 安装 NetherGate.API
dotnet add package NetherGate.API

方式二：直接安装

dotnet new classlib -n MyPlugin
cd MyPlugin
dotnet add package NetherGate.API --source https://nuget.pkg.github.com/virgil698/index.json

2. 编写代码

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 已禁用");
    }
}

3. 构建并加载

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

完整教程： 第一个插件 | 插件开发指南

📚 丰富的功能 API

NetherGate 提供了完整的 API，让你能实现任何想法：

🎮 游戏交互

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

// 烟花系统 - 快速释放绚丽烟花
await context.GameUtilities.LaunchFireworkAsync(
    position, FireworkType.LargeBall, 
    colors: new[] { FireworkColor.Red, FireworkColor.Gold }
);

// 音乐播放器 - 在游戏中播放音符
await context.MusicPlayer.CreateMelody()
    .AddNote(Note.C, 200)
    .AddNote(Note.E, 200)
    .AddNote(Note.G, 400)
    .PlayAsync("@a");

📊 成就和统计追踪

// 实时追踪玩家成就进度（灵感来自 AATool）
var advancements = await context.AdvancementTracker.GetPlayerAdvancementsAsync(playerUuid);
context.Logger.Info($"成就完成度: {advancements.ProgressPercentage:F2}%");

// 监听成就完成事件
context.AdvancementTracker.AdvancementCompleted += async (s, e) => {
    await context.GameDisplay.SendTitleAsync("@a", 
        $"§6{e.PlayerName} 完成了 {e.AdvancementName}！"
    );
};

// 获取玩家游戏统计
var stats = await context.StatisticsTracker.GetPlayerStatisticsAsync(playerUuid);
context.Logger.Info($"游戏时长: {stats.PlayTimeSpan.TotalHours:F1} 小时");

📦 数据操作

// 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 items = await context.BlockDataReader.GetChestItemsAsync(chestPos);
var sortedItems = items.SortById().FilterEnchanted(); // 使用扩展方法
await context.BlockDataWriter.SetContainerItemsAsync(chestPos, sortedItems);

🎯 SMP 协议

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

🔧 RCON 命令

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

// 流式命令序列 - 延迟和重复执行
await context.GameUtilities.CreateSequence()
    .Execute(() => DoSomething())
    .WaitTicks(20)  // 等待 1 秒（20 ticks）
    .Execute(() => DoAnotherThing())
    .Repeat(3)      // 重复 3 次
    .RunAsync();

⚙️ 更多高级功能

🏆 排行榜系统：灵活的排行榜管理、分数更新、排名变化事件
📡 WebSocket 推送：实时数据广播到网页/OBS 覆盖层
💬 插件间通信：跨插件消息传递，模块化开发
📁 文件系统：安全的文件读写、变化监听、自动备份
🔒 权限系统：用户组、权限继承、通配符支持
⏱️ 性能监控：CPU、内存、TPS 实时监控
🎭 事件系统：30+ 事件类型，支持优先级
🎨 扩展方法库：物品堆排序/筛选、位置计算、统计分析

完整 API 文档： API 参考

📖 文档导航

🎓 新手入门

安装和配置
第一个插件 - 完整的签到插件示例
常见问题 (FAQ)

📘 核心功能

SMP 协议 - Server Management Protocol
RCON 集成 - 远程命令执行
NBT 数据操作 - 玩家/世界数据读写 (1.20.4-)
物品组件系统 - 数据组件操作 (1.20.5+)
事件系统 - 事件订阅和发布
权限系统 - 权限管理
命令系统 - 命令注册

🔧 插件开发

⚙️ 高级功能

🚀 架构优化

架构优化指南 ⭐ 最新
构造函数注入示例 ⭐ 最新
依赖注入 (DI)：支持构造函数注入
连接池：网络连接复用和管理
分布式插件：跨服务器节点通信

完整文档索引： docs/README.md

🤝 贡献

欢迎贡献代码、文档或建议！

报告 Bug：提交 Issue
功能建议：参与讨论
代码贡献：提交 Pull Request

贡献指南： CONTRIBUTING.md

📄 许可证

本项目采用 LGPL-3.0 License 开源协议。

💬 社区和支持

📖 文档中心：docs/README.md
🐛 问题反馈：GitHub Issues
💡 功能讨论：GitHub Discussions
📧 联系方式：查看 CONTRIBUTING.md

🌟 致谢

特别感谢

感谢以下项目为 NetherGate 提供了设计灵感和技术参考：

MCDReforged - 为 NetherGate 提供了优秀的插件系统设计思路和开发理念。MCDReforged 在 Python 生态中为 Minecraft 服务器管理树立了标杆，NetherGate 在继承这些优秀理念的基础上，结合 .NET 的高性能和现代化特性，为插件开发者带来更强大、更灵活的开发体验。
MinecraftConnection - 为 NetherGate 的 RCON 命令封装和游戏操作 API 设计提供了重要参考。该项目展示了如何优雅地封装 Minecraft 命令，NetherGate 在此基础上进一步扩展，实现了烟花系统、音乐播放器、箱子操作等高级功能，为开发者提供更便捷的游戏交互 API。
CTM's AATool - 为 NetherGate 的成就追踪和统计分析系统提供了设计灵感。AATool 是一个优秀的 Minecraft 成就追踪工具，展示了如何优雅地读取和追踪玩家数据。NetherGate 借鉴了其文件读取优化技术（安全的文件访问、避免锁定）和实时追踪机制，并结合 .NET 的异步特性，为插件开发者提供了强大的数据追踪和分析能力。

开源项目

感谢以下优秀的开源项目：

MCDReforged - 设计理念和灵感来源
MinecraftConnection - RCON 命令封装和游戏操作 API 设计参考
CTM's AATool - 成就追踪系统设计灵感和文件读取优化
fNbt - NBT 数据处理
YamlDotNet - YAML 配置支持
Minecraft Wiki - 技术文档参考

⭐ 如果觉得有用，请给个 Star！⭐

Made with ❤️ by NetherGate Team

文档中心 • API 参考 • 快速开始

NetherGate

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

简体中文 | English

✨ 为什么选择 NetherGate？

🎯 易于使用，功能强大

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

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

🚀 100% 功能覆盖率

核心能力	状态	说明
SMP 协议	✅ 100%	35 个方法 + 22 个通知处理
RCON 命令	✅ 100%	完整的游戏命令支持（60+ 命令）
日志监听	✅ 100%	服务器生命周期 + 玩家事件
网络事件	✅ 100%	4 种监听模式（LogBased 立即可用）
NBT 数据	✅ 100%	读取 + 写入（玩家/世界数据）
数据组件	✅ 100%	1.20.5+ 物品组件系统支持
方块数据	✅ 100%	箱子/漏斗/告示牌等容器读写
文件操作	✅ 100%	读写/监听/备份
性能监控	✅ 100%	CPU/内存/TPS
游戏实用工具	✅ 100%	烟花/音乐/时间/区域操作
扩展方法库	✅ 100%	物品堆/位置扩展方法
成就追踪	✅ 100%	实时追踪玩家成就进度
统计分析	✅ 100%	游戏统计/方块收集进度
排行榜系统	✅ 100%	灵活的排行榜管理
数据推送	✅ 100%	WebSocket 实时数据广播

💡 核心优势

⚡ 高性能：原生 .NET 编译，执行效率远超解释型语言
🛡️ 安全隔离：AssemblyLoadContext 机制，插件完全隔离
🎨 现代架构：
- ✅ 依赖注入 (DI)：支持构造函数注入，松耦合设计
- ✅ 异步 API：全异步编程模型，高性能
- ✅ 事件驱动：灵活的事件订阅和发布
- ✅ 连接池：网络连接复用，资源高效利用
- ✅ 分布式支持：跨服务器节点的插件通信
🔥 先进的热重载：
- ✅ 保留插件状态（数据不丢失）
- ✅ 支持代码修改后立即生效
- ✅ 自动卸载旧版本，加载新版本
- ✅ 插件间依赖自动重载
🌐 跨平台：支持 8 种平台架构组合
- Windows: x64, x86, ARM64
- Linux: x64, ARM, ARM64
- macOS: Intel x64, Apple Silicon ARM64
📚 文档完善：覆盖所有功能的中文文档，丰富示例

🎮 兼容性说明

支持的 Minecraft 版本

✅ Java Edition 1.21.9+（及以上版本）

支持的服务端类型

NetherGate 支持所有开放 RCON + SMP 协议的 Minecraft 服务端，包括但不限于：

Vanilla (原版)
Paper
Purpur
Leaves
Leaf
Forge
Fabric
NeoForge

前置要求：

✅ 服务端需开启 RCON 功能（用于命令执行）
✅ 服务端需支持 SMP 协议（用于服务器管理）

📥 快速开始

1. 下载

从 Releases 下载适合您系统的版本：

操作系统	架构	文件名
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

2. 配置

首次运行会自动生成配置文件：

cd bin/Release
./NetherGate.Host

或使用交互式配置向导：

./NetherGate.Host --wizard

配置文件示例： nethergate-config.yaml

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

详细配置： 配置文件详解

3. 启动

./NetherGate.Host

三种启动模式：

Java 模式：NetherGate 直接启动 Minecraft 服务器
Script 模式：使用现有启动脚本
External 模式：连接到已运行的服务器（仅管理功能）

🔌 5 分钟创建第一个插件

1. 安装 NuGet 包

NetherGate.API 发布在 GitHub Packages，安装前需要配置 NuGet 源：

方式一：使用项目配置文件（推荐）

在项目根目录创建 nuget.config：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <add key="github" value="https://nuget.pkg.github.com/virgil698/index.json" />
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
  </packageSources>
</configuration>

然后进行身份验证并安装：

# 配置 GitHub Packages 认证（使用 GitHub Personal Access Token）
dotnet nuget add source --username YOUR_GITHUB_USERNAME --password YOUR_GITHUB_TOKEN --store-password-in-clear-text --name github "https://nuget.pkg.github.com/virgil698/index.json"

# 创建插件项目
dotnet new classlib -n MyPlugin
cd MyPlugin

# 安装 NetherGate.API
dotnet add package NetherGate.API

方式二：直接安装

dotnet new classlib -n MyPlugin
cd MyPlugin
dotnet add package NetherGate.API --source https://nuget.pkg.github.com/virgil698/index.json

2. 编写代码

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 已禁用");
    }
}

3. 构建并加载

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

完整教程： 第一个插件 | 插件开发指南

📚 丰富的功能 API

NetherGate 提供了完整的 API，让你能实现任何想法：

🎮 游戏交互

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

// 烟花系统 - 快速释放绚丽烟花
await context.GameUtilities.LaunchFireworkAsync(
    position, FireworkType.LargeBall, 
    colors: new[] { FireworkColor.Red, FireworkColor.Gold }
);

// 音乐播放器 - 在游戏中播放音符
await context.MusicPlayer.CreateMelody()
    .AddNote(Note.C, 200)
    .AddNote(Note.E, 200)
    .AddNote(Note.G, 400)
    .PlayAsync("@a");

📊 成就和统计追踪

// 实时追踪玩家成就进度（灵感来自 AATool）
var advancements = await context.AdvancementTracker.GetPlayerAdvancementsAsync(playerUuid);
context.Logger.Info($"成就完成度: {advancements.ProgressPercentage:F2}%");

// 监听成就完成事件
context.AdvancementTracker.AdvancementCompleted += async (s, e) => {
    await context.GameDisplay.SendTitleAsync("@a", 
        $"§6{e.PlayerName} 完成了 {e.AdvancementName}！"
    );
};

// 获取玩家游戏统计
var stats = await context.StatisticsTracker.GetPlayerStatisticsAsync(playerUuid);
context.Logger.Info($"游戏时长: {stats.PlayTimeSpan.TotalHours:F1} 小时");

📦 数据操作

// 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 items = await context.BlockDataReader.GetChestItemsAsync(chestPos);
var sortedItems = items.SortById().FilterEnchanted(); // 使用扩展方法
await context.BlockDataWriter.SetContainerItemsAsync(chestPos, sortedItems);

🎯 SMP 协议

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

🔧 RCON 命令

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

// 流式命令序列 - 延迟和重复执行
await context.GameUtilities.CreateSequence()
    .Execute(() => DoSomething())
    .WaitTicks(20)  // 等待 1 秒（20 ticks）
    .Execute(() => DoAnotherThing())
    .Repeat(3)      // 重复 3 次
    .RunAsync();

⚙️ 更多高级功能

🏆 排行榜系统：灵活的排行榜管理、分数更新、排名变化事件
📡 WebSocket 推送：实时数据广播到网页/OBS 覆盖层
💬 插件间通信：跨插件消息传递，模块化开发
📁 文件系统：安全的文件读写、变化监听、自动备份
🔒 权限系统：用户组、权限继承、通配符支持
⏱️ 性能监控：CPU、内存、TPS 实时监控
🎭 事件系统：30+ 事件类型，支持优先级
🎨 扩展方法库：物品堆排序/筛选、位置计算、统计分析

完整 API 文档： API 参考

📖 文档导航

🎓 新手入门

安装和配置
第一个插件 - 完整的签到插件示例
常见问题 (FAQ)

📘 核心功能

SMP 协议 - Server Management Protocol
RCON 集成 - 远程命令执行
NBT 数据操作 - 玩家/世界数据读写 (1.20.4-)
物品组件系统 - 数据组件操作 (1.20.5+)
事件系统 - 事件订阅和发布
权限系统 - 权限管理
命令系统 - 命令注册

🔧 插件开发

⚙️ 高级功能

🚀 架构优化

架构优化指南 ⭐ 最新
构造函数注入示例 ⭐ 最新
依赖注入 (DI)：支持构造函数注入
连接池：网络连接复用和管理
分布式插件：跨服务器节点通信

完整文档索引： docs/README.md

🤝 贡献

欢迎贡献代码、文档或建议！

报告 Bug：提交 Issue
功能建议：参与讨论
代码贡献：提交 Pull Request

贡献指南： CONTRIBUTING.md

📄 许可证

本项目采用 LGPL-3.0 License 开源协议。

💬 社区和支持

📖 文档中心：docs/README.md
🐛 问题反馈：GitHub Issues
💡 功能讨论：GitHub Discussions
📧 联系方式：查看 CONTRIBUTING.md

🌟 致谢

特别感谢

感谢以下项目为 NetherGate 提供了设计灵感和技术参考：

MCDReforged - 为 NetherGate 提供了优秀的插件系统设计思路和开发理念。MCDReforged 在 Python 生态中为 Minecraft 服务器管理树立了标杆，NetherGate 在继承这些优秀理念的基础上，结合 .NET 的高性能和现代化特性，为插件开发者带来更强大、更灵活的开发体验。
MinecraftConnection - 为 NetherGate 的 RCON 命令封装和游戏操作 API 设计提供了重要参考。该项目展示了如何优雅地封装 Minecraft 命令，NetherGate 在此基础上进一步扩展，实现了烟花系统、音乐播放器、箱子操作等高级功能，为开发者提供更便捷的游戏交互 API。
CTM's AATool - 为 NetherGate 的成就追踪和统计分析系统提供了设计灵感。AATool 是一个优秀的 Minecraft 成就追踪工具，展示了如何优雅地读取和追踪玩家数据。NetherGate 借鉴了其文件读取优化技术（安全的文件访问、避免锁定）和实时追踪机制，并结合 .NET 的异步特性，为插件开发者提供了强大的数据追踪和分析能力。

开源项目

感谢以下优秀的开源项目：

MCDReforged - 设计理念和灵感来源
MinecraftConnection - RCON 命令封装和游戏操作 API 设计参考
CTM's AATool - 成就追踪系统设计灵感和文件读取优化
fNbt - NBT 数据处理
YamlDotNet - YAML 配置支持
Minecraft Wiki - 技术文档参考

⭐ 如果觉得有用，请给个 Star！⭐

Made with ❤️ by NetherGate Team

文档中心 • API 参考 • 快速开始

virgil698/NetherGate.APIv1.1.0

Get Started

Readme

NetherGate

✨ 为什么选择 NetherGate？

🎯 易于使用，功能强大

🚀 100% 功能覆盖率

💡 核心优势

🎮 兼容性说明

支持的 Minecraft 版本

支持的服务端类型

📥 快速开始

1. 下载

2. 配置

3. 启动

🔌 5 分钟创建第一个插件

1. 安装 NuGet 包

2. 编写代码

3. 构建并加载

📚 丰富的功能 API

🎮 游戏交互

📊 成就和统计追踪

📦 数据操作

🎯 SMP 协议

🔧 RCON 命令

⚙️ 更多高级功能

📖 文档导航

🎓 新手入门

📘 核心功能

🔧 插件开发

⚙️ 高级功能

🚀 架构优化

🤝 贡献

📄 许可证

💬 社区和支持

🌟 致谢

特别感谢

开源项目

virgil698/NetherGate.APIv1.1.0

Get Started

Readme

NetherGate

✨ 为什么选择 NetherGate？

🎯 易于使用，功能强大

🚀 100% 功能覆盖率

💡 核心优势

🎮 兼容性说明

支持的 Minecraft 版本

支持的服务端类型

📥 快速开始

1. 下载

2. 配置

3. 启动

🔌 5 分钟创建第一个插件

1. 安装 NuGet 包

2. 编写代码

3. 构建并加载

📚 丰富的功能 API

🎮 游戏交互

📊 成就和统计追踪

📦 数据操作

🎯 SMP 协议

🔧 RCON 命令

⚙️ 更多高级功能

📖 文档导航

🎓 新手入门

📘 核心功能

🔧 插件开发

⚙️ 高级功能

🚀 架构优化

🤝 贡献

📄 许可证

💬 社区和支持

🌟 致谢

特别感谢

开源项目