MC Guns System
适用于 Minecraft 26.3 的枪械、《使命召唤》风格的游戏模式以及僵尸模式,以数据包和资源包形式提供。无需模组。
这是 TheBradqq 开发的 MGS 4.2 的重制版,主要复用了其模型、纹理和音效。其余部分均为全新内容。

安装
- 下载最新版本。
- 将
MCGunsSystem_datapack_with_libs.zip 放入世界的 datapacks 文件夹中。
它包含了 Bookshelf、Smithed Actionbar 以及其他所需的库。
- 启用
MCGunsSystem_resource_pack_with_libs.zip 作为资源包。
- 打开世界,或重启服务器。
- 运行
/function mgs:config 打开管理菜单,并从“游戏设置”开始游戏。
指令
| 指令 |
适用对象 |
功能 |
/function mgs:config |
管理员 |
管理菜单:开始游戏、打开地图编辑器、服务器选项 |
/function mgs:_give_all |
管理员 |
给予整合包中的所有物品 |
/loot give @s loot mgs:i/<item> |
管理员 |
给予单个物品,例如 mgs:i/ak47 |
/trigger mgs.player.config set 1 |
所有玩家 |
玩家选项、统计数据、排行榜和僵尸刀迷彩。快捷操作键可打开相同菜单 |
/function mgs:zombies/recover |
管理员 |
恢复卡住的僵尸回合进度 |
武器
大约三十种枪械,详见此处(手枪、冲锋枪、步枪、轻机枪、霰弹枪、狙击枪、RPG-7 和 Ray Gun),此外还有破片手雷、Semtex、烟雾弹和闪光弹,以及一把带有三种僵尸升级的匕首。
- 命中即伤子弹,具备散布、伤害衰减和爆头判定。火箭弹会飞行并爆炸。
- 每种枪械保留其原始开火模式(全自动、半自动、三连发、泵动)。按住
Q 键丢弃枪械即可切换模式。
- 弹匣与备用弹药、快速换弹与快速装填、后坐力、抛出的弹壳、动作栏中的弹药 HUD。
- 针对瞄准镜缩放、枪口火焰、准星散布和低血量状态的光影效果。
- 每把枪械在僵尸模式中均拥有 Pack-a-Punch 强化属性。
多人游戏
六种游戏模式:自由混战、团队死斗、据点争夺、关键点控制、搜索与摧毁和爆破拆除。
玩家在每次复活前选择职业。整合包自带几个平衡性良好的职业,并通过“十选一”编辑器构建自定义职业及专长。自定义职业可以公开分享、浏览、筛选、点赞并设为默认。任务使用相同的职业系统。
击杀和胜利会给予经验值,用于提升多人游戏等级,挑战则作为进度解锁。
当玩家击杀终结一场自由混战、团队死斗或搜捕摧毁模式的比赛时,击杀回放会在总结画面之前,从最终击杀者的视角回放其连续击杀过程至每位玩家。
任务 (Missions)
合作 PvE。地图上放置的每个敌人在开始时生成,指南针指向剩余的敌人,当没有剩余敌人时任务结束。排行榜记录每张地图的最佳时间。
僵尸 (Zombies)
《黑色行动》风格的回合制生存模式。整合包自带一张地图:Kino der Toten。
- 僵尸随回合数增加而变得更快、更强。特殊僵尸在第 5 回合(快速)、第 10 回合(坦克)、第 15 回合(持枪)和第 20 回合(护盾光环僵尸,可保护尸潮)加入。特殊回合会出现猎犬,且从第 8 回合开始的每第 10 回合为鸡骑士回合。
- 击杀和维修获得的点数可用于购买门、墙买物品、电源开关、陷阱和神秘箱。
- 14 种 Perk:Juggernog、Speed Cola、Double Tap、Quick Revive、Mule Kick、Stamin-Up、PhD Flopper、Deadshot Daiquiri、Timeslip、Electric Cherry、Tombstone、Who's Who、Dying Wish 和 Widow's Wine,可从它们的机器或 Der Wunderfizz 处获得。
- Pack-a-Punch、路障、倒地与复活、猴子炸弹。
- 11 种道具:Max Ammo、Insta Kill、Double Points、Carpenter、Nuke、Unlimited Ammo、Random Perk、Free PAP、Cash Drop、Fire Sale 和 Bonfire Sale。
- 玩家断开连接和服务端重启时,当前进程会被保存,并在玩家重新连接后恢复。
- 排行榜记录每张地图和玩家数量下的最佳回合数。僵尸等级可解锁刀具迷彩。
同一服务器上可以同时运行一场多人游戏、一次任务流程和一次僵尸流程,彼此之间不可见。但相同模式的两个游戏无法共存。
世界中的排行榜
放置一个循环命令方块,设置为“始终激活”,并让它运行以下任一函数:
function mgs:leaderboard/level_zb
function mgs:leaderboard/level_mp
function mgs:leaderboard/zb_map {map:"kino_der_toten",players:"all"}
function mgs:leaderboard/mi_map {map:"<mission id>"}
当玩家在 24 格范围内时,排行榜悬浮于该方块上方。
取消勾选方块的“追踪输出”,或运行 /gamerule command_block_output false,否则它将填满管理员的聊天栏。
地图编辑器
所有三种模式的地图均可在游戏中制作。通过 /function mgs:config、游戏设置打开它,然后选择模式和地图,或创建新地图。
编辑器提供各类元素的生成蛋,每种元素对应一种。将生成蛋放置在元素应处的位置:
| 模式 |
元素 |
| 多人游戏 |
红色、蓝色和共享出生点,搜捕摧毁、夺旗和据点的目标点 |
| 任务 |
玩家出生点,敌人(附带设置每个敌人的函数) |
| 僵尸 |
玩家、僵尸和特殊僵尸出生点,墙买物品,门,陷阱,Perk 机器,神秘箱位置,电源开关 |
| 全部 |
基准坐标,边界角点,越界点 |
配置生成蛋会在聊天中列出元素的字段:门的价格和开启所需的门、陷阱的持续时间和冷却时间、Perk 机器的 Perk 和价格。出生点和神秘箱位置也会获得表单,且出生点的激活框会以粒子形式显示。
销毁生成蛋移除最近的元素,其聊天消息中包含“撤销”按钮。
首先放置基准坐标:所有位置都相对于它们保存,因此一旦放置好基准,地图即可在任何世界中运行。

将地图打包进整合包
-
在编辑器中保存地图。
-
使用 /data get storage mgs:maps <mode>[{id:"<id>"}] 打印数据,其中 <mode> 为 multiplayer、zombies 或 missions。
-
将生成的复合数据粘贴到生成器中,位于现有地图之后,并在其 ID 检查条件之后:
execute unless data storage mgs:maps multiplayer[{id:"hijacked"}] run data modify storage mgs:maps multiplayer append value {...}
| 模式 |
文件 |
注册方式 |
运行时机 |
| 多人游戏 |
src/functional/multiplayer/maps.py |
#mgs:maps/register |
每次加载时 |
| 僵尸 |
src/functional/zombies/maps.py |
#mgs:zombies/register_maps |
每次僵尸游戏开始时 |
| 任务 |
src/functional/missions/maps.py |
暂无 |
|
如果世界已包含具有该 ID 的地图,则保留其副本,因此游戏中的编辑在重载后依然有效。
要将更改后的内置地图推送到世界,请先移除存储的数据,例如 /data remove storage mgs:maps multiplayer[{id:"hijacked"}],然后运行 /reload。
另一个数据包也可以以相同的方式打包地图,通过其自身的函数放入 #mgs:maps/register 或 #mgs:zombies/register_maps 中。
地图脚本
地图从其所属的函数标签 #mgs:maps/<script>_script 运行自己的命令,其中 <script> 为 start、tick、join、leave、respawn 或 power(僵尸模式中通电时)。这些命令在地图的基准坐标处运行。
每张地图都会向相同的标签中添加内容,因此每个脚本首先检查其游戏是否正在其自己的地图上运行。maps/multiplayer/hijacked/calls/ 和 maps/zombies/kino_der_toten/calls/ 展示了具体用法。
从源代码构建
需要 uv 0.9 或更高版本,该工具会自动获取 Python 3.14。
uv sync
uv run stewbeet
数据包、资源包以及四个 zip 文件会生成在 build/ 目录下,该目录由 git 跟踪,且不应手动编辑。beet.yml 中的 build_copy_destinations 会将这些文件复制到作者的 Windows 文件夹中。在其他情况下,StewBeet 会打印警告并继续运行。
检查项均通过 uv run python scripts/verify.py <command> 运行:
| 命令 |
功能 |
baseline |
保存 build/ 以作为后续比较的基准 |
check [--diff] |
重新构建并列出与基准相比发生的变化(忽略注释和空行) |
validate |
使用 mecha 解析每个函数,并列出缺失和无法访问的资源 |
server --java <Java 25 的绝对路径> |
在真实的 26.3 服务器中加载并重载数据包 |
lint |
ruff、pyright strict、complexipy |
修改 src/functional/progression/awards.py 中的经验奖励或挑战阈值后,在游戏中运行 /function mgs:v<version>/progression/recompute_all(例如 mgs:v5.3.0/...)。它会根据玩家储存的经验值,重新计算所有在线玩家的等级和挑战进度。
文件位置说明
src/setup_definitions.py 注册来自 src/config 统计数据和 src/database 构建器的所有物品。
src/link.py 写入每个函数,src/functional/ 下的每个包对应一个系统:weapon、core(模式共享的边界、地图、生成点和菜单)、progression、stats、multiplayer、missions、zombies、map_editor、shaders。
assets/ 包含纹理、音效和光影。specs/ 为每个计划中的功能提供一个文件夹,其 README 列出了各项功能的当前状态。
MC Guns System
Guns, Call of Duty style game modes and a Zombies mode for Minecraft 26.3, as a datapack and a resource pack. No mods.
It is a rewrite of MGS 4.2 by TheBradqq, whose models, textures and sounds it mostly reuses. The rest is new.

Install
- Download the latest release.
- Put
MCGunsSystem_datapack_with_libs.zip in the world's datapacks folder.
It bundles Bookshelf, Smithed Actionbar and the other libraries it needs.
- Enable
MCGunsSystem_resource_pack_with_libs.zip as a resource pack.
- Open the world, or restart server.
- Run
/function mgs:config to open the admin menu, and start a game from Game Setup.
Commands
| Command |
For |
What it does |
/function mgs:config |
operators |
Admin menu: start a game, open the map editor, server options |
/function mgs:_give_all |
operators |
Gives every item of the pack |
/loot give @s loot mgs:i/<item> |
operators |
Gives one item, for example mgs:i/ak47 |
/trigger mgs.player.config set 1 |
everyone |
Player options, stats, leaderboards and Zombies knife camos. The Quick Actions key opens the same menu |
/function mgs:zombies/recover |
operators |
Unsticks a Zombies round that stopped progressing |
Weapons
About thirty guns, listed here (pistols, SMGs, rifles, LMGs, shotguns, snipers, the RPG-7 and the Ray Gun), plus frag, semtex, smoke and flash grenades, and a knife with three Zombies upgrades.
- Hitscan bullets with spread, damage falloff and headshots. Rockets travel and explode.
- Each gun keeps its original fire modes (auto, semi, burst, pump). Drop the gun (
Q) to switch.
- Magazines and reserve ammo, quick swap and quick reload, recoil, ejected casings, an ammo HUD in the actionbar.
- Shaders for the scope zoom, the muzzle flash, crosshair spread and low health.
- Every gun has Pack-a-Punch stats for Zombies.
Multiplayer
Six game modes: Free For All, Team Deathmatch, Domination, Hardpoint, Search and Destroy and Demolition.
Players pick a class before each life. A few balanced classes ship with the pack, and a pick-10 editor builds custom ones with perks. Custom classes can be made public, browsed, filtered, liked and set as default. Missions use the same classes.
Kills and wins give XP towards a Multiplayer level, and challenges unlock as advancements.
When a player kill ends a Free For All, Team Deathmatch or Search and Destroy match, a kill cam replays the final killer's streak from their eyes to every player before the summary.
Missions
Co-op PvE. Every enemy placed on the map spawns at the start, a compass points at the remaining ones, and the mission ends when none is left. Leaderboards keep the best time per map.
Zombies
Round-based survival in the style of Black Ops. One map ships with the pack, Kino der Toten.
- Zombies get faster and tougher by round. Special zombies join at round 5 (fast), 10 (tank), 15 (armed with a gun) and 20 (an aura zombie that shields the horde). Special rounds bring hounds, and every 10th round from round 8 is a chicken jockey round.
- Points from kills and repairs pay for doors, wallbuys, the power switch, traps and the Mystery Box.
- 14 perks: Juggernog, Speed Cola, Double Tap, Quick Revive, Mule Kick, Stamin-Up, PhD Flopper, Deadshot Daiquiri, Timeslip, Electric Cherry, Tombstone, Who's Who, Dying Wish and Widow's Wine, from their machines or from Der Wunderfizz.
- Pack-a-Punch, barricades, downs and revives, monkey bombs.
- 11 power-ups: Max Ammo, Insta Kill, Double Points, Carpenter, Nuke, Unlimited Ammo, Random Perk, Free PAP, Cash Drop, Fire Sale and Bonfire Sale.
- A run survives players disconnecting and a server restart, and resumes when they come back.
- Leaderboards keep the best round per map and player count. The Zombies level unlocks knife camos.
One Multiplayer match, one Missions run and one Zombies run can play on the same server at the same time without seeing each other. Two games of the same mode cannot.
Leaderboards in the world
Place a repeat command block, set it to Always Active, and make it run one of these:
function mgs:leaderboard/level_zb
function mgs:leaderboard/level_mp
function mgs:leaderboard/zb_map {map:"kino_der_toten",players:"all"}
function mgs:leaderboard/mi_map {map:"<mission id>"}
The board floats above the block while a player is within 24 blocks.
Untick the block's Track Output, or run /gamerule command_block_output false, or it fills the operators' chat.
Map editor
Maps of all three modes are made in game. Open it from /function mgs:config, Game Setup, then pick a mode and a map, or create one.
The editor gives spawn eggs, one per kind of element. Place them where the element goes:
| Mode |
Elements |
| Multiplayer |
red, blue and shared spawns, objective points for Search and Destroy, Domination and Hardpoint |
| Missions |
player spawns, enemies (with the function that sets each one up) |
| Zombies |
player, zombie and special spawns, wallbuys, doors, traps, perk machines, Mystery Box spots, the power switch |
| All |
base coordinates, boundary corners, out-of-bounds points |
The Configure egg lists an element's fields in chat: a door's price and the doors it opens with, a trap's duration and cooldown, a perk machine's perk and price. Spawns and Mystery Box spots also get a form, and a spawn's activation box shows as particles.
The Destroy egg removes the nearest element, and its chat message has a Revert button.
Place the base coordinates first: every position is saved relative to them, so a map works in any world once its base is placed.

Ship a map with the pack
-
Save the map in the editor.
-
Print it with /data get storage mgs:maps <mode>[{id:"<id>"}], where <mode> is multiplayer, zombies or missions.
-
Paste the compound in the generator, next to the existing maps, behind a check on its id:
execute unless data storage mgs:maps multiplayer[{id:"hijacked"}] run data modify storage mgs:maps multiplayer append value {...}
| Mode |
File |
Registered by |
Runs |
| Multiplayer |
src/functional/multiplayer/maps.py |
#mgs:maps/register |
on every load |
| Zombies |
src/functional/zombies/maps.py |
#mgs:zombies/register_maps |
at every Zombies game start |
| Missions |
src/functional/missions/maps.py |
none yet |
|
A world that already has a map with that id keeps its own copy, so edits made in game survive a reload.
To push a changed built-in map to a world, remove the stored one first, for example /data remove storage mgs:maps multiplayer[{id:"hijacked"}], then /reload.
Another datapack can ship maps the same way, from its own function in #mgs:maps/register or #mgs:zombies/register_maps.
Map scripts
A map runs its own commands from the function tags #mgs:maps/<script>_script, where <script> is start, tick, join, leave, respawn or power (Zombies, when the power turns on). They run at the map's base coordinates.
Every map adds to the same tags, so each script first checks that its game is running on its own map. maps/multiplayer/hijacked/calls/ and maps/zombies/kino_der_toten/calls/ show how.
Build from source
Needs uv 0.9 or newer, which fetches Python 3.14.
uv sync
uv run stewbeet
The datapack, the resource pack and the four zips land in build/, which is tracked in git and never edited by hand.
build_copy_destinations in beet.yml copies them to the author's Windows folders. Elsewhere StewBeet prints a warning and goes on.
Checks, all run with uv run python scripts/verify.py <command>:
| Command |
What it does |
baseline |
Saves build/ to compare against |
check [--diff] |
Rebuilds and lists what changed since the baseline, ignoring comments and blank lines |
validate |
Parses every function with mecha and lists missing and unreachable resources |
server --java <absolute path to Java 25> |
Loads and reloads the pack in a real 26.3 server |
lint |
ruff, pyright strict, complexipy |
After changing XP awards in src/functional/progression/awards.py or a challenge threshold, run /function mgs:v<version>/progression/recompute_all in game (for example mgs:v5.3.0/...). It rebuilds every online player's levels and challenges from their banked XP.
Where things are
src/setup_definitions.py registers every item from the stats in src/config and the builders in src/database.
src/link.py writes every function, one package of src/functional/ per system: weapon, core (bounds, maps, spawning, menus shared by the modes), progression, stats, multiplayer, missions, zombies, map_editor, shaders.
assets/ holds textures, sounds and shaders. specs/ holds one folder per planned feature, and its README lists their state.
评论 0
登录后参与评分
还没有评论,来抢沙发吧