Azathoth Website

Azathoth 官方网站 — 为 Minecraft MMORPG 服务器框架提供资源市场、项目生成器、社区论坛、开发者文档和 API 文档。

项目结构

azathoth-website/
├── frontend/          # Nuxt 3 前端应用
│   ├── pages/         # 页面路由
│   ├── components/    # Vue 组件
│   ├── composables/   # 组合式函数
│   ├── stores/        # Pinia 状态管理
│   ├── layouts/       # 布局（default / docs / wiki）
│   ├── locales/       # i18n 语言文件（zh / en）
│   ├── content/       # Nuxt Content 文档（Markdown）
│   └── types/         # TypeScript 类型定义
└── backend/           # Ktor 后端 API 服务
    └── src/main/
        ├── kotlin/    # Kotlin 源码
        └── resources/ # 配置文件

技术栈

前端

技术	版本	说明
Nuxt 3	3.20+	Vue 3 全栈框架
Tailwind CSS	3.x	原子化 CSS
Pinia	3.x	状态管理
Vue I18n	9.x	国际化（中/英）
Nuxt Content	3.x	Markdown 文档渲染
Marked	17.x	Markdown 解析

后端

技术	版本	说明
Kotlin	2.3.0	主语言
Ktor	3.3.3	HTTP 服务框架
Exposed	1.0.0-rc	ORM 框架
PostgreSQL	-	主数据库
MongoDB	5.3.x	文档存储
Redis (Lettuce)	7.2.x	缓存与会话
JWT	-	认证

快速开始

环境要求

• Node.js >= 20
• JDK >= 25
• PostgreSQL
• Redis

前端

cd frontend
npm install
npm run dev

默认运行在 http://localhost:3000，API 代理到 http://localhost:8080/api。

生产环境域名：https://www.mcwar.cn，API 地址：https://www.mcwar.cn/api。

后端

cd backend
./gradlew run

默认运行在 http://localhost:8080。

首次运行前，复制配置文件并填写本地数据库连接信息：

cp src/main/resources/application.conf src/main/resources/application-local.conf

构建

# 前端
cd frontend && npm run build

# 后端
cd backend && ./gradlew buildFatJar
# 产物: backend/build/libs/azathoth-website-backend.jar

功能模块

模块	路径	说明
首页	/	框架介绍、热门资源、最新发布
资源市场	/market	插件/模块/模板的搜索、下载、购买、评价
项目生成器	/generator	可视化创建 Azathoth 插件项目脚手架
社区论坛	/forum	帖子发布、分类浏览、回复互动
开发者文档	/docs	框架使用文档（架构、游戏系统、API 等）
API 文档	/wiki	后端 REST API 接口文档
用户认证	/auth	登录、注册、忘记密码

国际化

支持中文（默认）和英文两种语言，语言文件位于 frontend/locales/。

切换语言通过导航栏的语言切换按钮实现。

许可证

MIT