
- ⭐感谢所有支持我们的玩家!
- ?如果想查看更多内容,请访问 SOLEA PIXEL
- ⚒️在此查看 Wiki [正在建设中]

BETTER MINECRAFT:顾名思义,“Better” 是一款模组,为 Minecraft 提供了广泛的基础增强内容,无需安装数十个不同的模组即可提升游戏体验。
请注意,本模组具有“原版风格”;其目标并非添加特殊机器或过于强大的能力等特性。该模组旨在适应 Minecraft 的世界观并保持在其宇宙框架内。(Better Minecraft 的创作初衷是,在我看来,成为那些我认为非常酷的 Minecraft 更新之一。)
如果您希望通过分享想法或概念参与本项目,请前往我们的官方 Discord。
? 补充信息
本模组与多个其他模组兼容,例如
- Just Enough Items [JEI]
- Jade
这有助于改善新玩家的游戏体验。
同时,它也很容易整合到您的整合包中,因为本模组能很好地与其他模组融合,并提供一系列能够增强您模组生存体验的功能。

Minecraft 往往容易变得重复乏味;最终你会发现游戏里的一切都已司空见惯。这就是为什么 BETTER MINECRAFT 脱颖而出,它就像是那个永远不会在 Minecraft 正式版中发布的 1.22 更新。通过安装我们的模组,您可以探索我们提供的各种新增内容。
? 模组中的新增内容示例
- Enderite 盔甲与工具
- Emerald 盔甲与工具
- 新的注魔台
- 新的末地 / 主世界生物群系
- 兼容性:JEI / JADE
- 新的附魔及更多
随着更新的到来,模组中还有更多精彩内容等待发现,你还在等什么?
想使用 BMCMOD 进行创作?
⚠️稳定版:版本 26.1 !
稳定标识符 (com.soleapixel.bmcmod.api.BmcModIds)
在插件中使用这些 ResourceLocation 常量,以避免硬编码字符串。它们匹配当前版本的注册表路径。
| 常量 |
路径 |
BmcModIds.MAYOR_BELL_BLOCK |
bmcmod:mayor_bell (方块) |
BmcModIds.MAYOR_BELL_ITEM |
bmcmod:mayor_bell (物品) |
BmcModIds.VILLAGE_MAYOR_SPAWN_EGG |
bmcmod:village_mayor_spawn_egg |
BmcModIds.CONSTRUCTION_GUIDE |
bmcmod:construction_guide |
BmcModIds.PROFESSION_MAYOR |
bmcmod:mayor (VillagerProfession) |
BmcModIds.PROFESSION_CURED_WITCH |
bmcmod:cured_witch |
注意: 游戏内的方块/物品逻辑仍通过主模组中的 ModBlocks / ModItems 解析;BmcModIds 仅用于跨模组引用、配方和条件判断(在你的代码或数据包中)。
标签约定(数据包与跨模组)
标签位于 data/bmcmod/tags/… 下。在 JSON 中当 Minecraft 需要引用标签时,请使用 #bmcmod:…。
镇长 / 村庄集成(可在你的插件中扩展)
| 标签 ID |
类型 |
用途 |
#bmcmod:mayor_bells |
block |
所有充当“镇长钟”的方块,用于过滤、任务或兼容性检查(针对 你的 模组)。基础模组仍会在代码中注册自己的方块;请将你的方块 ID 添加至此,以保持生态一致性。 |
#bmcmod:mayor_bells |
item |
同上,适用于物品形式(方块物品)。 |
示例(你的插件的数据包):
{
"replace": false,
"values": ["yourmod:golden_mayor_bell"]
}
如果你添加了自定义铃铛方块,必须使其能鸣响并使用 BellBlockEntity:
- 你的方块应表现出铃铛的行为(例如继承
BellBlock 或复制其行为)。
- 通过 NeoForge 的
BlockEntityTypeAddBlocksEvent 将其注册到 BlockEntityType.BELL(与此模组处理 MAYOR_BELL 的模式相同)。
- 将你的方块/物品添加到
#bmcmod:mayor_bells,以便其他模组和数据包可以一次性定位所有镇长钟。
本模组中其他有用的命名空间
#c:…(通用/惯例)—— 例如 c:tags/item/tools/scythe 用于兼容性。请将你的物品添加到你生态系统中期望的 c / forge / neoforge 标签中。
- 位于
data/bmcmod/tags/item/ 下的物品标签(如 scythes, foundry_shards, boreal_ingots, 附魔潜力列表等)由数据包驱动;插件物品可以通过 "replace": false 合并进来。
注册表(代码入口点)
| 注册表 |
类(仅供参考) |
| 方块 / 物品 |
com.soleapixel.bmcmod.registry.ModBlocks, ModItems |
| 村民职业 |
com.soleapixel.bmcmod.villager.ModProfessions |
| 方块实体类型 |
com.soleapixel.bmcmod.registry.ModBlockEntityTypes |
| 实体、声音、粒子等 |
ModEntities, ModSounds, ModParticles 等 |
| 全局战利品 / GLM |
com.soleapixel.bmcmod.registry.ModGlobalLoot |
村庄存档数据(按维度):BmcVillageSavedData —— 键 = 村庄锚点(来自 BlockPos 的长整型)。
事件(NeoForge)—— 挂钩位置
除非另有说明,这些事件均使用 @EventBusSubscriber(modid = "bmcmod", …) 订阅于游戏总线。插件模组应根据需要设置适当的 EventPriority,并且除非你在 mods.toml 中声明了显式依赖关系,否则不要假设加载顺序。
| 领域 |
示例类 / Hook |
| 村民交易 |
VillagerTradesEvent, TradeWithVillagerEvent — 参见 village.mayor.VillageEconomyEvents |
| 市长死亡 |
LivingDeathEvent — VillageMayorDeathEvents |
| 服务器刻(选举/生命周期) |
ServerTickEvent.Post — MayorElectionScheduler, VillageLifecycleEvents |
| POI 扩展 |
Mod Bus: ExtendPoiTypesEvent — 为市长铃铛扩展原版铃铛 POI(BmcMod 设置) |
| 方块实体类型 |
Mod Bus: BlockEntityTypeAddBlocksEvent — SunwoodRegistryEvents(铃铛/告示牌使用相同模式) |
兼容性提示: 优先监听 NeoForge 事件 或 数据包(标签、战利品表),而非混入位于 com.soleapixel.bmcmod.mixin 内的 mixin 目标,后者可能在 BMC 版本更新之间发生变化。
Mixins
- 配置:
resources/bmcmod.mixins.json。
- 将 mixin 目标视为 脆弱的 API:它们可能因 Minecraft 或 NeoForge 更新而失效。
- 对于插件模组:避免遮蔽 BMC 的 mixins;尽可能使用 NeoForge 事件、标签 或 无 ASM 的注册表 Hook。
数据包 & 资源路径
- 合成表:
data/bmcmod/recipe/
- 战利品表:
data/bmcmod/loot_table/
- 战利品修饰符:
data/bmcmod/loot_modifiers/
- 结构 / 世界生成:
data/bmcmod/worldgen/ 以及随附的原版池(位于 data/minecraft/ 中)
- 标签:
data/bmcmod/tags/<type>/<path>.json
mods.toml 依赖片段(插件模组)
[[dependencies.yourmod]]
modId = "bmcmod"
type = "required" # 或 "optional" 如果仅软兼容
versionRange = "[26.0.3,)" # 与你测试过的 BMC 主版本对齐
ordering = "NONE"
side = "BOTH"
调整版本范围以匹配 gradle.properties → mod_version,即你进行测试的 BMC 构建版本。
API & 文档更新日志
| 日期 |
更改 |
| 2026-05-09 |
首次发布 release/dev.md:#bmcmod:mayor_bells(方块 + 物品)、com.soleapixel.bmcmod.api.BmcModIds、Modrinth 简介维护者检查清单。 |
(每当集成表面发生变化时,请追加新行。)
许可证 / 重新分发
遵循 BMC jar / 仓库中声明的许可证(如用户 mods.toml 所示的 SOLEA PIXEL)。在重新分发 本开发指南 时,请确保你的分支的更新日志部分保持真实准确。

- ⭐Thank you to everyone who supports us!
- ?If you want to see more, go to SOLEA PIXEL
- ⚒️Check out the wiki here [Under construction]

BETTER MINECRAFT: As the name suggests, “Better” is a mod that offers a wide range of essential additions to Minecraft, improving the game without requiring you to install 30 different mods.
Note that this mod is “vanilla-like”; the goal isn’t to add features such as special machines or overpowered abilities. The mod must adapt to Minecraft and stay within its universe. (Better Minecraft was created to be, in my opinion, one of several Minecraft updates that I think would be cool to add.)
If you’d like to participate in the project by sharing your ideas or concepts, head over to our official Discord.
? Additional Information
This mod is compatible with several other mods, such as
- Just Enough Items [JEI]
- Jade
This helps improve the experience for new players.
It’s also easy for you to include it in your modpacks, as this mod blends in well with others and offers a range of features that can enhance your modded survival experience.

Minecraft has often become repetitive; eventually, you end up seeing everything there is to see. That’s why BETTER MINECRAFT stands out as the new 1.22 update that will never be released in Minecraft. You can discover our various additions and more by installing our mod.
? Example of addition in the mods
- Enderite Armor & Tools
- Emerald Armor & Tools
- New Infusion Table
- New Biome End / Overworld
- Compatibilities : JEI / JADE
- News Enchant & More
And there is much more to discover in the mods as the updates come, so what are you waiting for?
Would you like to create with BMCMOD?
⚠️Stable : Version 26.1 !
Stable identifiers (com.soleapixel.bmcmod.api.BmcModIds)
Use these ResourceLocation constants in addons to avoid hard-coded strings. They match registry paths for the current version.
| Constant |
Path |
BmcModIds.MAYOR_BELL_BLOCK |
bmcmod:mayor_bell (block) |
BmcModIds.MAYOR_BELL_ITEM |
bmcmod:mayor_bell (item) |
BmcModIds.VILLAGE_MAYOR_SPAWN_EGG |
bmcmod:village_mayor_spawn_egg |
BmcModIds.CONSTRUCTION_GUIDE |
bmcmod:construction_guide |
BmcModIds.PROFESSION_MAYOR |
bmcmod:mayor (VillagerProfession) |
BmcModIds.PROFESSION_CURED_WITCH |
bmcmod:cured_witch |
Note: Gameplay still resolves blocks/items through ModBlocks / ModItems in the main mod; BmcModIds is for cross-mod references, recipes, and conditions in your own code or datapacks.
Tag conventions (datapack & cross-mod)
Tags live under data/bmcmod/tags/…. Use #bmcmod:… in JSON where Minecraft expects a tag.
Mayor / village integration (extend in your addon)
| Tag ID |
Type |
Purpose |
#bmcmod:mayor_bells |
block |
All blocks that act as a “Mayor Bell” for filtering, quests, or compatibility in your mod. The base mod still registers its own block in code; add your block id here for ecosystem consistency. |
#bmcmod:mayor_bells |
item |
Same for the item form (block items). |
Example (your addon’s datapack):
{
"replace": false,
"values": ["yourmod:golden_mayor_bell"]
}
If you add a custom bell block that must ring and use BellBlockEntity:
- Your block should behave like a bell (e.g. extend
BellBlock or mirror behavior).
- Register it on
BlockEntityType.BELL via NeoForge BlockEntityTypeAddBlocksEvent (same pattern as this mod for MAYOR_BELL).
- Add your block/item to
#bmcmod:mayor_bells so other mods and datapacks can target all mayor bells at once.
Other useful namespaces in this mod
#c:… (common / convention) — e.g. c:tags/item/tools/scythe is used for compatibility. Add your items to the c / forge / neoforge tags your ecosystem expects.
- Item tags under
data/bmcmod/tags/item/ (e.g. scythes, foundry_shards, boreal_ingots, enchantability lists) are datapack-driven; addon items can be merged in with "replace": false.
Registries (code entry points)
| Registry |
Class (indicative) |
| Blocks / Items |
com.soleapixel.bmcmod.registry.ModBlocks, ModItems |
| Villager professions |
com.soleapixel.bmcmod.villager.ModProfessions |
| Block entity types |
com.soleapixel.bmcmod.registry.ModBlockEntityTypes |
| Entities, sounds, particles, … |
ModEntities, ModSounds, ModParticles, etc. |
| Global loot / GLM |
com.soleapixel.bmcmod.registry.ModGlobalLoot |
Village saved data (per dimension): BmcVillageSavedData — key = village anchor (long from BlockPos).
Events (NeoForge) — where to hook
These use @EventBusSubscriber(modid = "bmcmod", …) on the game bus unless noted. Add-on mods should subscribe with EventPriority appropriately and not assume load order unless you declare an explicit dependency in mods.toml.
| Area |
Example classes / hooks |
| Villager trades |
VillagerTradesEvent, TradeWithVillagerEvent — see village.mayor.VillageEconomyEvents |
| Mayor death |
LivingDeathEvent — VillageMayorDeathEvents |
| Server tick (elections / lifecycle) |
ServerTickEvent.Post — MayorElectionScheduler, VillageLifecycleEvents |
| POI extension |
Mod bus: ExtendPoiTypesEvent — vanilla bell POI extended for mayor bell (BmcMod setup) |
| Block entity types |
Mod bus: BlockEntityTypeAddBlocksEvent — SunwoodRegistryEvents (same pattern for bells/signs) |
Compatibility tip: prefer listening to NeoForge events or datapacks (tags, loot tables) over mixin targets inside com.soleapixel.bmcmod.mixin, which may change between BMC releases.
Mixins
- Configuration:
resources/bmcmod.mixins.json.
- Treat mixin targets as fragile API: they can break on Minecraft or NeoForge updates.
- For addons: avoid shadowing BMC mixins; use NeoForge events, tags, or ASM-free registry hooks when possible.
Datapacks & resource paths
- Recipes:
data/bmcmod/recipe/
- Loot tables:
data/bmcmod/loot_table/
- Loot modifiers:
data/bmcmod/loot_modifiers/
- Structures / worldgen:
data/bmcmod/worldgen/ and patched vanilla pools under data/minecraft/ where shipped
- Tags:
data/bmcmod/tags/<type>/<path>.json
mods.toml dependency snippet (addon mod)
[[dependencies.yourmod]]
modId = "bmcmod"
type = "required" # or "optional" if soft-compat only
versionRange = "[26.0.3,)" # align with the BMC major you tested against
ordering = "NONE"
side = "BOTH"
Adjust version range to match gradle.properties → mod_version for the BMC build you test against.
API & docs changelog
| Date |
Change |
| 2026-05-09 |
Initial publication of release/dev.md: #bmcmod:mayor_bells (block + item), com.soleapixel.bmcmod.api.BmcModIds, maintainer checklist for Modrinth bio. |
(Append new rows whenever integration surfaces change.)
License / redistribution
Follow the license declared in the BMC jar / repository (SOLEA PIXEL as shown in user mods.toml). When redistributing this dev guide, keep the changelog section honest with your fork.
评论 0
登录后参与评分
还没有评论,来抢沙发吧