TPanle

一个基于LeviLamina lse的Minecraft插件，用于创建一个面板。

快速开始

1. 克隆此模板仓库
2. 安装依赖: npm install
3. 开发模式: npm run dev
4. 生产构建: npm run build
5. 构建并打包为 Zip: npm run build:zip

开发模式

项目提供了多种开发模式以适应不同的开发需求：

1. 普通开发模式: npm run dev

   • 监听前后端文件变更并自动重新构建
   • 部署到Minecraft服务器

2. 快速快速模式: npm run dev:fast

   • 前端变更由vite处理
   • 后端变更将自动构建
   • 部署到Minecraft服务器

3. 前端开发服务器: npm run dev:frontend

   • 启动React开发服务器，支持热重载
   • 无法连接到后端服务器

代码检查

# 运行 ESLint 检查后端代码
npm run lint

# 自动修复可修复的 ESLint 问题
npm run lint:fix

项目使用 ESLint + @typescript-eslint 对后端 src/ 目录进行静态检查。规则配置在 .eslintrc.cjs 中。 lint 命令仅输出警告（warnings），不会阻断构建流程。

持续集成

项目通过 GitHub Actions 自动执行 CI 检查。配置位于 .github/workflows/ci.yml，触发条件如下：

• 推送到 main / master 分支
• Pull Request 到 main / master 分支

CI 流程包含以下步骤：

1. 安装依赖 — npm ci
2. 代码检查 — npm run lint（确保无 ESLint 错误）
3. 生产构建 — npm run build（确保构建通过）

CI 在 Node.js 18 和 20 两个版本上分别运行。

开发说明

后端开发

后端代码位于 src/ 目录下，使用 TypeScript 编写。

前端开发

前端代码位于 frontend/ 目录下，使用 React 和 TypeScript 构建，采用 Ant Design 组件库实现 UI。

许可证

MIT