Craft.Net 技术文档

1. 安装指南

安装依赖

Craft.Net 项目依赖于以下库：

• DotNetZip：用于 zlib 压缩/解压
• fNbt：用于 NBT 数据操作
• BouncyCastle：在 Mono 上进行加密

在 Windows 上，需要将 "C:\Windows\Microsoft.NET\Framework\v4.0.30319" 添加到系统路径。在 Linux 和 Mac 上，需要安装 Mono 2.10 或更高版本。

克隆项目

使用以下命令克隆 Craft.Net 项目，包括所有子模块：

git clone --recursive git://github.com/SirCmpwn/Craft.Net.git

如果已经克隆了项目，可以使用以下命令手动更新子模块：

git submodule update --init

构建项目

• 在 Windows 上，打开命令行，进入项目根目录，运行：

  msbuild
  

• 在 Linux 和 Mac 上，进入项目根目录，运行：

  xbuild
  

• 也可以使用 Visual Studio 2010 或更新版本，以及 MonoDevelop 或 SharpDevelop 进行构建。

2. 项目的使用说明

Craft.Net 是一组与 Minecraft 相关的 .NET 库，可以根据需要选择不同的库来完成不同的任务。支持的库包括：

• Craft.Net.AI：用于驱动生物行为的人工智能（计划中）
• Craft.Net.Anvil：支持编辑 Minecraft Anvil 世界
• Craft.Net.Client：Minecraft 多人游戏客户端库
• Craft.Net.Common：Minecraft 数据类型和常用工具
• Craft.Net.Entities：Minecraft 实体的结构和行为
• Craft.Net.Logic：处理方块和物品交互逻辑
• Craft.Net.Networking：通用的 Minecraft 网络支持
• Craft.Net.Physics：旨在重现 Minecraft 物理的简单物理引擎
• Craft.Net.Server：Minecraft 多人游戏服务器库
• Craft.Net.TerrainGeneration：各种地形生成器

支持 Minecraft 1.7.5 版本。

3. 项目API使用文档

具体 API 使用方法请参考项目 Wiki 文档。

示例：使用 Networking

// 创建一个围绕 NetworkStream 的 MinecraftStream
var minecraftStream = new MinecraftStream(networkStream);
// 使用 PacketReader 类读取数据包
var packetReader = new PacketReader(minecraftStream);

示例：运行服务器

var server = new MinecraftServer(new IPEndPoint(IPAddress.Any, 25565));
var generator = new FlatlandGenerator();
// 在 "world" 目录下创建一个使用 flatland 生成器的世界
server.AddLevel(new Level(generator, "world"));
server.Start();

示例：连接到服务器

var session = new Session("PlayerName");
// 使用用户的 saved lastlogin 文件（取消注释以使用）
// var lastLogin = LastLogin.GetLastLogin();
// var session = Session.DoLogin(lastLogin.Username, lastLogin.Password);
var client = new MinecraftClient(session);
// 连接到 127.0.0.1:25565 服务器
client.Connect(new IPEndPoint(IPAddress.Loopback, 25565));

示例：编辑世界

var level = Level.LoadFrom("world");
level.DefaultWorld.SetBlockId(Coordinates3D.Zero, 22); // 设置为青金石方块
level.Save();

4. 项目安装方式

请参考上述“安装指南”部分，按照步骤进行安装。