diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..3cd414d
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,11 @@
+GNU Affero General Public License v3.0 or later
+
+Copyright (C) 2026 GroupMountain
+
+This project is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+
+This project is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License along with this project. If not, see <https://www.gnu.org/licenses/agpl-3.0.html>.
+
+SPDX-License-Identifier: AGPL-3.0-or-later
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..51dc2e1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,62 @@
+# ModAPI
+
+ModAPI 是 GroupMountain 维护的 Minecraft Bedrock Dedicated Server 模组开发接口库，面向基于 LeviLamina 与 GMLIB 的服务器扩展开发。项目提供一组 C++20 API，用于注册和管理自定义物品、方块、配方、游戏规则、世界生成、战利品表、效果、实体等内容。
+
+## 功能概览
+
+- 自定义物品、护甲、工具和食物组件注册接口
+- 自定义合成、熔炉、酿造、切石、锻造等配方接口
+- 自定义游戏规则、世界生成特征、战利品表、状态效果和实体接口
+- Addons 加载支持
+- 基于 xmake 的构建流程，并在构建后生成 DLL、PDB、LIB、头文件和 `manifest.json`
+
+## 环境要求
+
+- Windows / Visual Studio C++ 工具链
+- [xmake](https://xmake.io/)
+- C++20 编译环境
+- 依赖包：
+  - LeviLamina `26.10.*`
+  - LeviBuildScript `0.6.0`
+  - GMLIB `26.10.0`
+
+依赖仓库已在 `xmake.lua` 中配置：
+
+- `https://github.com/LiteLDev/xmake-repo.git`
+- `https://github.com/GroupMountain/xmake-repo.git`
+
+## 构建
+
+```bash
+xmake f -m release
+xmake
+```
+
+构建完成后，产物会复制到 `bin/` 目录，主要包括：
+
+- `bin/dll/ModAPI/ModAPI.dll`
+- `bin/dll/ModAPI/manifest.json`
+- `bin/pdb/ModAPI.pdb`
+- `bin/lib/ModAPI.lib`
+- `bin/include/`
+
+## 项目结构
+
+```text
+include/modapi/   对外公开的 ModAPI 头文件
+src/modapi/       ModAPI 内部实现
+src/mc/           Minecraft / LeviLamina 相关适配实现
+scripts/          构建辅助脚本
+xmake.lua         xmake 构建配置
+```
+
+## 开发说明
+
+- 公开接口头文件位于 `include/modapi/`。
+- 构建前会自动执行头文件包含修正和格式化脚本。
+- 版本信息由 `scripts/get-version-info.lua` 读取并注入到 `include/modapi/Version.h.in` 生成的配置头中。
+- 发布产物的 `manifest.json` 由 `scripts/generate-manifest.lua` 生成。
+
+## 许可证
+
+本项目基于 GNU Affero General Public License v3.0 或更新版本（AGPL-3.0-or-later）开源。完整许可文本见 [LICENSE](LICENSE)。