{"id":34594891,"url":"https://github.com/creepebucket/programmable_magic","last_synced_at":"2026-05-01T13:01:03.970Z","repository":{"id":310756635,"uuid":"1040588252","full_name":"creepebucket/programmable_magic","owner":"creepebucket","description":"mc mod 可编程魔法, 真的完全可编程 1.21.11 neo","archived":false,"fork":false,"pushed_at":"2026-04-12T06:39:29.000Z","size":23481,"stargazers_count":22,"open_issues_count":0,"forks_count":7,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-12T08:20:49.200Z","etag":null,"topics":["magic","minecraft","minecraft-mod","neoforge-mod","neoforged","technology"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/creepebucket.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-08-19T07:56:12.000Z","updated_at":"2026-04-12T06:34:59.000Z","dependencies_parsed_at":"2026-02-28T16:02:45.947Z","dependency_job_id":null,"html_url":"https://github.com/creepebucket/programmable_magic","commit_stats":null,"previous_names":["creepebucket/programmable_magic"],"tags_count":109,"template":false,"template_full_name":null,"purl":"pkg:github/creepebucket/programmable_magic","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creepebucket%2Fprogrammable_magic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creepebucket%2Fprogrammable_magic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creepebucket%2Fprogrammable_magic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creepebucket%2Fprogrammable_magic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/creepebucket","download_url":"https://codeload.github.com/creepebucket/programmable_magic/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creepebucket%2Fprogrammable_magic/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32497815,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["magic","minecraft","minecraft-mod","neoforge-mod","neoforged","technology"],"created_at":"2025-12-24T11:28:00.945Z","updated_at":"2026-05-01T13:01:03.963Z","avatar_url":"https://github.com/creepebucket.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n---\n\n# Programmable Magic (可编程魔法)\n\n\u003cdiv align=\"center\"\u003e\n\n[![Gradle Package](https://github.com/creepebucket/programmable_magic/actions/workflows/gradle-publish.yml/badge.svg)](https://github.com/creepebucket/programmable_magic/actions/workflows/gradle-publish.yml)\n[![mc_version](https://img.shields.io/badge/minecraft-1.21.11-brightgreen?logo=minecraft)](https://github.com/creepebucket/programmable_magic)\n[![last_commit](https://img.shields.io/github/last-commit/creepebucket/programmable_magic?logo=github)](https://github.com/creepebucket/programmable_magic/commits)\n[![release](https://img.shields.io/github/v/release/creepebucket/programmable_magic?include_prereleases\u0026logo=github)](https://github.com/creepebucket/programmable_magic/releases)\n[![bilibili](https://img.shields.io/badge/bilibili-演示视频-00A1D6?logo=bilibili\u0026logoColor=white)](https://www.bilibili.com/video/BV1mHS8BWE9u)\n[![repo](https://img.shields.io/badge/repo-programmable_magic-181717?logo=github\u0026logoColor=white)](https://github.com/creepebucket/programmable_magic)\n\n![GitHub Repo Card](https://githubcard.com/creepebucket/programmable_magic.svg?d=dU-_JTBK)\n\n\u003c/div\u003e\n\n## 📖 简介 (Overview)\n\n**Programmable Magic** 是一个基于 NeoForge 1.21.11 的技术向魔法模组。\n\n在这里，魔法不再是简单的“按键释放”，而是一门**工程学**。你需要将一组「法术卡片」编排进魔杖，构建出可复用的**施法序列**。通过引入变量、逻辑判断与数学计算，你可以将魔法写成一段可执行的“程序”。\n\n随着游戏的推进，配合插件系统与魔力网络，你将从手搓火球走向魔法自动化工业。\n\n\u003e [!WARNING]\n\u003e **开发状态提示**：目前模组仍处于**早期开发阶段 (Alpha/Beta)**，内容、数值平衡与合成配方可能会频繁调整。\n\n## ✨ 核心特性 (Features)\n\n### 1. 逻辑构建，而非数值堆砌\n拒绝枯燥的等级碾压。强度的上限取决于你的**构建逻辑（Build）**。\n- **模块化施法**：将“效果”、“修饰”、“控制”与“计算”卡片像代码一样组合。\n- **高复用性**：一套优秀的法术序列可以针对不同场景（战斗、挖掘、移动）进行快速改装。\n\n### 2. 深度自定义的法术系统\n- **基础效果**：爆炸、加速、方块放置、药水云、数据打印等。\n- **流程控制**：支持 `if/else` 条件判断、`while` 循环、逻辑运算（与/或/非）及比较运算。\n- **数学表达式**：提供数字常量、四则运算、幂运算及括号支持。拒绝硬编码，让参数随心所欲。\n- **动态参数**：实时获取施法者位置、视线向量、目标实体数据，实现“自瞄”或“追踪”逻辑。\n\n### 3. 多维度的魔力体系\n引入四系魔力作为施法成本，为后续的“魔力工业”奠定基础：\n- ☢️ **辐射 (Radiation)**\n- 🔥 **温度 (Temperature)**\n- 💨 **动量 (Momentum)**\n- 🧱 **压力 (Pressure)**\n\n### 4. 硬件与扩展\n- **魔杖插件**：通过插件扩展魔杖的内存（卡槽）、供能效率与释放模式，定制你的专属法器。\n- **魔力网络 (WIP)**：实装线缆、产生器、缓存器与路由设备，目标是实现法术的远程传输与自动化执行。\n\n## 📥 安装指南 (Installation)\n\n1.  **环境要求**：\n  - Minecraft `1.21.11`\n  - NeoForge `21.11.19-beta` 或更高版本\n2.  **下载**：请前往 [GitHub Releases](https://github.com/creepebucket/programmable_magic/releases) 下载最新构建。\n3.  **安装**：将下载的 `.jar` 文件放入游戏目录下的 `mods` 文件夹即可。\n\n## 🛠️ 构建与开发 (Build \u0026 Dev)\n\n如果你想参与开发或自行构建：\n\n- **JDK 版本**：JDK 21 (Gradle Toolchain 会自动处理)\n- **常用命令**：\n  - 构建模组：`./gradlew build`\n  - 运行客户端：`./gradlew runClient`\n  - 生成数据 (DataGen)：`./gradlew runData`\n- **资源流水线**：\n  - 贴图切片：运行 `src/main/resources/buildassets.sh` (Windows下为 `.ps1`)，依赖 Python Pillow 库。\n  - 自动化：DataGen 产物会在构建时自动合并，无需手动维护 `generated` 目录。\n\n\u003cdetails\u003e\n\u003csummary\u003e📂 点击展开代码结构概览\u003c/summary\u003e\n\n```text\nsrc/main/java/org/creepebucket/programmable_magic\n├─ spells/           # 法术核心：效果/调整/控制/载体/计算、序列执行机\n├─ gui/wand/         # 交互界面：魔杖UI、编程面板\n├─ items/            # 物品注册：法术卡、魔杖、魔力单元\n├─ mananet/          # 魔力网络：传输协议与设备逻辑\n├─ block/            # 方块与TileEntity\n├─ registries/       # 注册中心 (DeferredRegisters)\n└─ data/             # DataGen (配方、模型、LootTable)\n\nsrc/main/resources\n├─ assets/           # 静态资源 (Lang, Textures)\n└─ build_assets.*    # 资源处理脚本\n```\n\u003c/details\u003e\n\n## 🗺️ 路线图 (Roadmap)\n\n- [x] 基础法术序列与执行系统\n- [x] 数学表达式与逻辑控制\n- [x] 基础魔杖与插件系统\n- [ ] **魔法科技化**：设备化的法术执行器、总线式网络、红石信号互转。\n- [ ] **生态完善**：更多“载体”与“计算”模组，建立从开荒到后期的完整生产线。\n\n## 📄 许可 (License)\n\n**源代码**：采用 GPLv3 协议开源。\n\n**美术资源**：本模组的美术资源包含原作者保留所有权利（ARR）的资产，以及部分原作者授权的第三方资产。绝大部分美术资源不可自由挪用。\n详细的资源版权归属与来源名单，请务必查看项目中的 ASSET_LICENSE.md 文件。\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://www.star-history.com/#creepebucket/programmable_magic\u0026type=date\u0026legend=top-left\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=creepebucket/programmable_magic\u0026type=date\u0026theme=dark\u0026legend=top-left\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=creepebucket/programmable_magic\u0026type=date\u0026legend=top-left\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=creepebucket/programmable_magic\u0026type=date\u0026legend=top-left\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n\u003c/div\u003e\n\n---","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcreepebucket%2Fprogrammable_magic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcreepebucket%2Fprogrammable_magic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcreepebucket%2Fprogrammable_magic/lists"}