Disguises
一款强大的、基于服务端的 Fabric 伪装模组,灵感来源于 LibsDisguises。可以将玩家或任何实体伪装成几乎任意类型的生物、动物、玩家、方块展示、物品、载具或投射物,支持细粒度的单实体自定义、装备覆盖、自身视角支持以及完全可配置的权限系统。
所有逻辑均在服务端运行,因此你的玩家只需加入游戏即可使用,无需安装客户端模组或资源包。
支持超过 100 种实体类型,从被动动物和敌对生物到其他玩家(带有其真实皮肤)、方块展示、物品、每种船和矿车的变体以及投射物。每种类型都有各自独立的标志位,用于设置颜色、年龄、姿态、装备、驯服状态和职业等,并支持完整的 Tab 补全。
构建说明及源代码请参阅 GitHub 仓库。
需要 Fabric Loader 和 Fabric API。主要构建版本针对 Minecraft 26.2,同时提供适用于 26.1.2 和 1.21.11 的替代构建版本。
功能特性
万物皆可伪装
- 玩家可以伪装成任何生物、动物、玩家皮肤或无生命实体
- 服务端上的生物和实体也可以被伪装(例如:将僵尸伪装成村民)
- 观察者特定的覆盖,可以让某一位玩家看到与其他人不同的伪装效果
- 伪装效果在区块切换和维度转换间保持持久化(可配置)
自身视角支持
玩家可以可选地以第三人称木偶视角查看自己的伪装,实时同步蹲下、疾跑、游泳和鞘翅滑翔的状态。
玩家皮肤与保存预设
玩家可以伪装为指定名称的玩家皮肤,缓存获取到的皮肤,并保存可复用的伪装预设以便快速重新应用。
隐身感知数据包处理
支持观察者特定的伪装和隐身提供者,包括针对隐身实体的内置记分板标签回退方案。
声音替换
环境音、受伤声、死亡声和脚步声会自动替换为对应伪装类型的声音。
消息中的伪装名称
服务器管理员可选择在签名聊天装饰和面向玩家的系统消息(如死亡提示和进度成就)中显示伪装名称。真实的账户身份对于 UUID、个人资料、命令、权限、日志和签名聊天举报仍保持完整,并可选地提供真实名称的悬停提示框。
广泛的实体自定义
每种伪装类型都支持通过伪装命令内联设置实体专属的标志位:
| 类别 |
示例标志位 |
| 通用 |
setFire, setInvisible, setGlowing, setCustomName, setCrouching |
| 活体实体 |
setHealth, setBaby |
| 羊 |
setColor RED, setSheared |
| 苦力怕 |
setPowered, setIgnited |
| 狼 / 猫 |
setTamed, setAngry, setCollarColor BLUE |
| 村民 |
setVillagerType plains, setProfession librarian, setVillagerLevel 3 |
| 马 |
setHorseColor chestnut, setHorseStyle white_field |
| 熊猫 |
setMainGene playful, setHiddenGene brown |
| 潜影贝 |
setAttachFace north, setPeek 50, setShulkerColor CYAN |
| 盔甲架 |
setSmall, setShowArms, setHeadPose 0 45 0 |
| 方块展示 / 下落方块 / 矿车 |
setBlock diamond_block |
| 物品实体 |
setItem diamond |
| 所有活体伪装 |
setHelmet iron_helmet, setMainHand diamond_sword |
支持对所有标志位及其值进行完整的 Tab 补全。
支持的实体类型
100+ 种实体类型涵盖所有类别:
- 被动动物:牛、羊、猪、马、驴、骡子、猫、狼、狐狸、熊猫、美西螈、青蛙、山羊、蜜蜂、炽足鸟、鹦鹉、兔子、骆驼、海龟、哞菇、村民、铁傀儡、雪傀儡,等等
- 敌对/中立生物:僵尸、骷髅、苦力怕、末影人、烈焰人、监守者、旋风使者、掠夺者、猪灵、劫掠兽、潜影贝、幻翼、史莱姆、岩浆怪,等等
- 玩家:伪装成任意玩家(带有其皮肤)
- 方块/展示实体:下落方块、方块展示、物品
- 载具:全部 20 种船变体,全部 7 种矿车类型
- 投射物:箭、三叉戟、烟花火箭、末影珍珠、雪球,等等
命令
权限可在 disguises.json 中按命令单独配置。
| 指令 |
描述 |
/disguise <type> [flags...] |
将自己伪装成指定类型 |
/disguise player <name> [flags...] 或 /disguise as <name> [flags...] |
将自己伪装成指定玩家皮肤 |
/disguise <type> <target> [flags...] |
将其他玩家伪装成指定类型 |
/disguise <type> <target> player <name> [flags...] |
将其他玩家伪装成指定玩家皮肤 |
/disguise entity <target> <type> [flags...] |
将目标实体伪装成指定类型 |
/disguise entity <target> player <name> [flags...] |
将目标实体伪装成指定玩家皮肤 |
/disguise radius <r> <type> [flags...] |
将半径内所有实体伪装成指定类型 |
/disguise radius <r> player <name> [flags...] |
将半径内所有实体伪装成指定玩家皮肤 |
/disguise modify <flags...> |
修改当前活动的伪装效果 |
/disguise viewself [on|off] |
切换是否能看到自己的伪装效果 |
/undisguise [target] |
移除伪装效果 |
/undisguise radius <r> |
移除半径内所有实体的伪装效果 |
/disguises reload |
重新加载配置文件 |
/disguises info [player] |
显示当前活动伪装信息 |
/disguises list |
列出所有当前被伪装的实体 |
/disguises clearcache |
清除玩家皮肤缓存 |
/disguises names |
显示聊天/系统消息中的伪装名称设置 |
/disguises names <chat|system|hover> <on|off> |
更改并持久化伪装名称设置(death 是 system 的别名) |
/disguises observer <target> <viewer> <type> [flags] |
设置针对特定观察者的伪装覆盖 |
/disguises removeobserver <target> <viewer> |
移除单个针对特定观察者的伪装覆盖 |
/disguises clearobservers <target> |
移除某实体所有针对特定观察者的伪装覆盖 |
/savedisguise save <name> <type> [flags...] |
保存个人伪装预设 |
/savedisguise apply <name> |
应用已保存的伪装预设 |
/savedisguise list |
列出你保存的伪装预设 |
/savedisguise delete <name> |
删除已保存的伪装预设 |
/disguisehelp [type] |
列出伪装类型或某类型的可用参数 |
配置
disguises.json(位于你的 config 文件夹中):
| 选项 |
默认值 |
描述 |
showDisguiseActionBar |
true |
在操作栏中显示伪装类型 |
actionBarIntervalTicks |
100 |
操作栏提醒出现的频率(0 = 仅在变更时显示) |
disguiseSounds |
true |
使用伪装类型的声音替换原声音 |
selfDisguiseDefault |
false |
玩家默认能看到自己的伪装效果 |
showDisguiseInTab |
false |
在皮肤加载期间,使假人伪装在标签页列表中可见 |
tabRemoveDelayTicks |
20 |
生成后延迟多少刻才从标签页列表中移除假人条目 |
disguiseNamesInChat |
false |
在聊天中以签名的显示名称形式展示伪装名称(也可通过 /disguises names chat 配置) |
disguiseNamesInDeathMessages |
false |
在全局系统消息(如死亡和进度完成)中展示伪装名称(使用 /disguises names system) |
revealRealNameOnHover |
true |
悬停在替代名称上时显示真实账户名(也可通过 /disguises names hover 配置) |
vanishedEntitiesHidden |
true |
对未授权观察者隐藏已消失状态的伪装实体 |
undisguiseOnDeath |
false |
玩家死亡时移除伪装效果 |
undisguiseOnWorldChange |
false |
维度变化时移除伪装效果 |
persistDisguises |
false |
跨服务器重启保存并恢复伪装效果 |
showEquipmentThroughDisguise |
false |
透过伪装显示实体原本的物品装备 |
enforceTypePermissions |
false |
按实体类型要求 disguises.type.<type> 权限 |
maxSavedPresetsPerPlayer |
50 |
每位玩家最多保存的预设数量(0 = 无限制) |
permLevelSelf/Others/Entity/Radius |
2 |
各类命令所需的 OP 等级 |
permLevelAdmin |
3 |
/disguises 管理命令所需的 OP 等级 |
permLevelType |
4 |
在没有权限插件的情况下,按类型权限使用的备用 OP 等级 |
disabledEntityTypes |
[] |
禁止使用的实体类型列表 |
依赖项
- Fabric Loader
- Fabric API
- 主构建版本:Minecraft 26.2
- 备选构建版本:Minecraft 26.1.2 和 1.21.11
灵感来源
LibsDisguises
Disguises
A powerful, server-side Fabric disguise mod inspired by LibsDisguises. Disguise players or any entity as virtually any mob, animal, player, block display, item, vehicle, or projectile, with fine-grained per-entity customisation, equipment overrides, self-view support, and a fully configurable permission system.
Everything runs on the server, so your players just join and it works. There is no client mod or resource pack to install.
Over 100 entity types are supported, from passive animals and hostile mobs to other players (with their real skins), block displays, items, every boat and minecart variant, and projectiles. Each type takes its own flags for things like colour, age, pose, equipment, tameness and professions, all with full tab-completion.
For build instructions and source, see the GitHub repository.
Requires Fabric Loader and Fabric API. The main build targets Minecraft 26.2, with alternate 26.1.2 and 1.21.11 builds available.
Features
Disguise anything as anything
- Players can disguise as any mob, animal, player skin, or inanimate entity
- Server-side mobs and entities can also be disguised (e.g. disguise a zombie as a villager)
- Observer-specific overrides, make one player see a different disguise than everyone else
- Disguises persist across chunks and dimensions (configurable)
Self-view support
Players can optionally see their own disguise from a third-person puppet perspective, mirroring their crouch, sprint, swim, and elytra state in real time.
Player skins and saved presets
Players can disguise as named player skins, cache fetched skins, and save reusable disguise presets for quick re-application.
Vanish-aware packet handling
Observer-specific disguises and vanish providers are supported, including a built-in scoreboard-tag fallback for vanished entities.
Sound replacement
Ambient, hurt, death, and footstep sounds are automatically replaced with the disguise type's sounds.
Disguise names in messages
Server owners can optionally show disguise names in signed chat decoration and
player-facing system messages such as deaths and advancements. Real account
identities remain intact for UUIDs, profiles, commands, permissions, logs, and
signed-chat reporting, with an optional real-name hover tooltip.
Extensive entity customisation
Every disguise type supports entity-specific flags set inline with the disguise command:
| Category |
Example flags |
| Universal |
setFire, setInvisible, setGlowing, setCustomName, setCrouching |
| Living entities |
setHealth, setBaby |
| Sheep |
setColor RED, setSheared |
| Creeper |
setPowered, setIgnited |
| Wolf / Cat |
setTamed, setAngry, setCollarColor BLUE |
| Villager |
setVillagerType plains, setProfession librarian, setVillagerLevel 3 |
| Horse |
setHorseColor chestnut, setHorseStyle white_field |
| Panda |
setMainGene playful, setHiddenGene brown |
| Shulker |
setAttachFace north, setPeek 50, setShulkerColor CYAN |
| Armor Stand |
setSmall, setShowArms, setHeadPose 0 45 0 |
| Block Display / Falling Block / Minecart |
setBlock diamond_block |
| Item entity |
setItem diamond |
| All living disguises |
setHelmet iron_helmet, setMainHand diamond_sword |
Full tab-completion for all flags and their values is supported.
Supported Entity Types
100+ entity types across all categories:
- Passive animals: Cow, Sheep, Pig, Horse, Donkey, Mule, Cat, Wolf, Fox, Panda, Axolotl, Frog, Goat, Bee, Strider, Parrot, Rabbit, Llama, Turtle, Mooshroom, Villager, Iron Golem, Snow Golem, and more
- Hostile / neutral mobs: Zombie, Skeleton, Creeper, Enderman, Blaze, Warden, Breeze, Pillager, Piglin, Ravager, Shulker, Phantom, Slime, Magma Cube, and more
- Player: Disguise as any player (with their skin)
- Block / display entities: Falling Block, Block Display, Item
- Vehicles: All 20 boat variants, all 7 minecart types
- Projectiles: Arrow, Trident, Firework Rocket, Ender Pearl, Snowball, and more
Commands
Permissions are configurable per-command in disguises.json.
| Command |
Description |
/disguise <type> [flags...] |
Disguise yourself |
/disguise player <name> [flags...] or /disguise as <name> [flags...] |
Disguise yourself as a named player skin |
/disguise <type> <target> [flags...] |
Disguise another player |
/disguise <type> <target> player <name> [flags...] |
Disguise another player as a named player skin |
/disguise entity <target> <type> [flags...] |
Disguise a targeted entity |
/disguise entity <target> player <name> [flags...] |
Disguise a targeted entity as a named player skin |
/disguise radius <r> <type> [flags...] |
Disguise all entities within radius |
/disguise radius <r> player <name> [flags...] |
Disguise all entities within radius as a named player skin |
/disguise modify <flags...> |
Modify your active disguise |
/disguise viewself [on|off] |
Toggle whether you see your own disguise |
/undisguise [target] |
Remove a disguise |
/undisguise radius <r> |
Remove disguises from all entities within radius |
/disguises reload |
Reload the config |
/disguises info [player] |
Show active disguise info |
/disguises list |
List all currently disguised entities |
/disguises clearcache |
Clear the player-skin cache |
/disguises names |
Show chat/system disguise-name settings |
/disguises names <chat|system|hover> <on|off> |
Change and persist a disguise-name setting (death is an alias for system) |
/disguises observer <target> <viewer> <type> [flags] |
Set a per-observer disguise override |
/disguises removeobserver <target> <viewer> |
Remove one per-observer disguise override |
/disguises clearobservers <target> |
Remove all per-observer overrides for an entity |
/savedisguise save <name> <type> [flags...] |
Save a personal disguise preset |
/savedisguise apply <name> |
Apply a saved disguise preset |
/savedisguise list |
List your saved disguise presets |
/savedisguise delete <name> |
Delete a saved disguise preset |
/disguisehelp [type] |
List disguise types or flags for one type |
Configuration
disguises.json (in your config folder):
| Option |
Default |
Description |
showDisguiseActionBar |
true |
Show the disguise type in the action bar |
actionBarIntervalTicks |
100 |
How often the action bar reminder appears (0 = only on change) |
disguiseSounds |
true |
Replace sounds with the disguise type's sounds |
selfDisguiseDefault |
false |
Players see their own disguise by default |
showDisguiseInTab |
false |
Keep fake player disguises visible in the tab list while skins load |
tabRemoveDelayTicks |
20 |
Ticks before removing a fake player tab entry after spawn |
disguiseNamesInChat |
false |
Show disguise names as signed-chat display names (also configurable with /disguises names chat) |
disguiseNamesInDeathMessages |
false |
Show global disguise names in system messages such as deaths and advancements (use /disguises names system) |
revealRealNameOnHover |
true |
Reveal the real account name when hovering a substituted name (also configurable with /disguises names hover) |
vanishedEntitiesHidden |
true |
Hide vanished disguised entities from unauthorized observers |
undisguiseOnDeath |
false |
Remove disguise when the player dies |
undisguiseOnWorldChange |
false |
Remove disguise on dimension change |
persistDisguises |
false |
Save and restore disguises across server restarts |
showEquipmentThroughDisguise |
false |
Show the real entity's equipment through the disguise |
enforceTypePermissions |
false |
Require disguises.type.<type> permission per entity type |
maxSavedPresetsPerPlayer |
50 |
Maximum saved presets per player (0 = unlimited) |
permLevelSelf/Others/Entity/Radius |
2 |
Op levels for each command category |
permLevelAdmin |
3 |
Op level for /disguises admin commands |
permLevelType |
4 |
Fallback op level for per-type permissions without a permissions mod |
disabledEntityTypes |
[] |
Block specific entity types from being used |
Requirements
- Fabric Loader
- Fabric API
- Main build: Minecraft 26.2
- Alternate builds: Minecraft 26.1.2 and 1.21.11
Inspired by
LibsDisguises
评论 0
登录后参与评分
还没有评论,来抢沙发吧