# FireFlyMain

**Repository Path**: pnchsb_admin/fire-fly-main

## Basic Information

- **Project Name**: FireFlyMain
- **Description**: FireFly
单一萤火，只能照亮一点；万千萤火，足以照亮世界。

FireFly 是一款面向《我的世界》Java版（含网易版）的开源工具箱。它图灵完备，支持通过 Bash / Python / JavaScript 调用任意系统命令与外部程序，让 Minecraft 的扩展能力不再受限于模组 API。同时提供更多丰富的内容和插件。与各大版块合并
- **Primary Language**: Python
- **License**: MPL-2.0
- **Default Branch**: master
- **Homepage**: https://firefly.nimbusapex.top
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-30
- **Last Updated**: 2026-05-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FireFly

**单一萤火，只能照亮一点；万千萤火，足以照亮世界。**

[![License](https://img.shields.io/badge/License-MPL%202.0-brightgreen.svg)](https://opensource.org/licenses/MPL-2.0)
[![Website](https://img.shields.io/badge/官网-firefly.nimbusapex.top-blue)](https://firefly.nimbusapex.top)

## 介绍

FireFly 是一款面向《我的世界》Java版（含网易版）的开源工具箱。

**它图灵完备**，支持通过 **Bash / Cmd / Python / JavaScript** 调用任意系统命令与外部程序，让 Minecraft 的扩展能力不再受限于模组 API。

简单来说：**任何能编译成可执行文件的语言，都可以通过 FireFly 与 Minecraft 交互。**

- **完全开源**（MPL 2.0 协议）
- **图灵完备**：可写出汉诺塔等复杂逻辑
- **任意语言可调用**：C++ / Rust / Go / Python / Node.js / 易语言……
- **团队维护**：官网、Bug反馈、长期在线支持
- **老用户权益不变**（永久有效），新用户免费 + 自愿捐赠


**核心原理：** FireFly 在 Minecraft 和操作系统之间建立一个「桥接层」。任何能被 Cmd / Bash 调用的程序，都可以被 FireFly 调用，进而控制或扩展 Minecraft。

## 安装教程

1. 下载最新版本：[官网下载页](https://firefly.nimbusapex.top)
2. 解压到任意目录（建议路径不要包含中文）
3. 运行 `FireFly.exe`（Windows）或 `./FireFly`（Linux/macOS）
4. 按照界面提示完成初始化

> 详细安装视频教程：[B站链接待补充]

## 使用说明

### 基础使用（普通用户）
1. 注册账号
2. 下载本项目
3. 下载或自己编写 Bash 脚本，放到指定位置后执行

> 功能持续更新中

### 进阶使用（开发者）
1. 用你熟悉的语言（Python / JS / C++ / ……）写一个可执行程序
2. 在 FireFly 中通过 Cmd / Bash 调用它，或写一个 `.firefly` 脚本放到 `Scripts/` 目录下
3. FireFly 会运行该程序，并根据输出与 Minecraft 交互

## 参与贡献

欢迎通过 Gitee Issues 提交 Bug 或创意建议。

## 开源协议

本项目使用 **Mozilla Public License Version 2.0**（MPL 2.0）。

- ✅ 你可以自由使用、修改、分发
- ✅ 你可以将本项目的代码放入你的闭源项目
- ✅ 如果你修改了 FireFly 的源文件，这些修改必须开源
- ❌ 不能删除版权声明

详见 [LICENSE](./LICENSE) 文件。

## 链接

- 🌐 [官方网站](https://firefly.nimbusapex.top)
- 💬 [QQ群] 1049026392

---

**愿萤火永世不熄。**