Opt Carpet Addition Mod

Language: English | 中文

这是一个Carpet的扩展模组，目标是添加一些没有太大改变原版游戏机制但优化玩家体验~~降低腐竹血压~~的一些功能。

警告: 不要下载以-source结尾的模组jar文件，那仅用于开发！！！

使用Preprocessor构建~~可供大家学习~~

本模组需要前置模组：Carpet fabric-api

各版本支持状态

其他与受支持的版本大版本相同小版本不同的MC版本，大多数可以直接安装正常工作，但是不能保证稳定性，请谨慎使用

Minecraft 版本	支持状态
1.20.4	支持，积极开发
1.20.1	支持，积极开发
1.19.3	支持，积极开发
1.18.2	支持，积极开发
1.17.1	支持，积极开发
1.16.5	不支持，停止维护（在`2023/1/8`停止维护）

规则

commandTpToFakePlayer

是否允许玩家通过/player xxx tp 指令传送到假人

有些服务器需要玩家之间互相tp的功能，如果使用tpa模组，就没法tp到假人（因为假人不会同意tpa），所以加入了这个功能
Default value: false
Acceptable value: true false ops
Categories: Command

commandTpHereFakePlayer

是否允许玩家通过/player xxx tphere 指令把假人传送到自己

有些服务器需要玩家之间互相tp的功能，如果使用tpa模组，就没法tphere假人（因为假人不会同意tpa），所以加入了这个功能
Default value: false
Acceptable value: true false ops
Categories: Command

allowTpToRealPlayer

是否允许玩家通过/player xxx tp 指令传送到真人

Default value: false
Acceptable value: true false ops
Categories: Command

allowTpHereRealPlayer

是否允许玩家通过/player xxx tphere 指令把真人传送到自己

Default value: false
Acceptable value: true false ops
Categories: Command

playerTpRateLimitTime

player xxx tp指令限速

默认值: 2 (单位: 秒) (每个玩家每2秒允许1次tp请求, 设为0则不限速)

Default value: 2
Acceptable value: 整数 >= 0 （∀ x ∈ N）（逃
Categories: Feature

fixXpLevelBug

修复在玩家跨越维度的时候经验值假归零的bug（在跨越维度时刷新玩家的经验条）

Default value: false
Acceptable value: true false
Categories: FixBug

forceFakePlayerGameMode

强制设定所有假人的游戏模式

只能强行设为生存(survival)、创造(creative)、冒险(adventure)，无法设为旁观者模式，因为在测试过程中强行设为旁观者模式会出现bug，目前不清楚具体原因

Default value: false
Acceptable value: survival creative adventure
Categories: Feature

enableTpPrefixBlacklist

感谢 @Water_Bucket 提供的灵感

开启假人Tp前缀黑名单功能
开启这个功能后，如果你要tp到的假人名字前缀在黑名单中，会阻止你tp到他并显示：You can't tp to this player because of tp limit.
比如你要tp到的假人叫做anti_mob，而黑名单中有一个anti，那你就不能tp到这个假人
假人的黑名单可以使用/tpmanager指令编辑（这个指令具体的用法看后面）

Default value: false
Acceptable value: true false
Categories: Feature

enableTpPrefixWhitelist

开启假人Tp前缀白名单功能
开启这个功能后，如果你要tp到的假人名字前缀不在白名单中，会阻止你tp到他并显示：You can't tp to this player because of tp limit.
比如你要tp到的假人叫做anti_mob，而白名单中没有anti，那你就不能tp到这个假人
假人的白名单可以使用/tpmanager指令编辑（这个指令具体的用法看后面）

Default value: false
Acceptable value: true false
Categories: Feature

enableTpHerePrefixBlacklist

开启假人Tphere前缀黑名单功能
开启这个功能后，如果你要tphere的假人名字的前缀在黑名单中，会阻止你tphere并显示：You can't tp to this player because of tp limit.
比如你要tphere的假人叫做anti_mob，而黑名单中有一个anti，那你就不能tphere这个假人
假人的黑名单可以使用/tpmanager指令编辑（这个指令具体的用法看后面）

Default value: false
Acceptable value: true false
Categories: Feature

enableTpHerePrefixWhitelist

开启假人Tphere前缀白名单功能
开启这个功能后，如果你要tphere的假人名字前缀不在白名单中，会阻止你tphere并显示：You can't tp to this player because of tp limit.
比如你要tphere的假人叫做anti_mob，而白名单中有一个anti，那你就能tp到这个假人
假人白名单可以使用/tpmanager指令编辑（这个指令具体的用法看后面）

Default value: false
Acceptable value: true false
Categories: Feature

disabledEnderManPickupGoal

禁止小黑搬起方块~~在末地施工小黑老搬方块好烦qwq~~

Default value: false
Acceptable value: true false
Categories: Feature

disabledEnderManPlaceBlockGoal

禁止小黑放下方块

Default value: false
Acceptable value: true false
Categories: Feature

disabledLayEggs

禁止鸡下蛋

Default value: false
Acceptable value: true false
Categories: Feature

disabledNetherPortalSpawn

禁止猪人生成在地狱门方块上

Default value: false
Acceptable value: true false
Categories: Feature

disabledEntityTick

注意！此规则可能会导致世界上所有的下落的方块实体无限回弹！！

此规则会跳过世界上一切实体的运算，不过玩家是正常的，开启此规则后，所有的生物全都会卡住，就算他们在空中也不会掉下来

此规则的目的是在服务器因为实体问题严重卡顿时，可以暂时缓解问题，但这不是最好的方案

Default value: false
Acceptable value: true false
Categories: Experimental

disabledUpdateSuppressionErrorStackTrace

此功能仅限1.17和1.18版本

此功能必须搭配carpet规则updateSuppressionCrashFix使用，否则无效

此规则可以让所有非致命的因为更新抑制导致的异常不刷屏，只输出一条日志：Update Suppression.
必须搭配carpet规则updateSuppressionCrashFix规则使用，否则无效
1.16和1.19版本无此规则，因为1.16和1.19的carpet没有updateSuppressionCrashFix规则
致命异常会正常输出并打印异常栈（致命异常指在不开启updateSuppressionCrashFix情况下会导致服务器崩溃的异常）

Default value: false
Acceptable value: true false
Categories: BugFix

unescapeChatMessage

此规则仅客户端有效，服务端无效

此规则会把客户端发出的所有应当转义的文字转义

例如在聊天栏输入：你好，\u4e2d\u6587
实际发送的消息是：你好，中文

Default value: false
Acceptable value: true false
Categories: Feature CLIENT

optimizePlayerConnect

仅1.17及1.18有此功能

优化玩家进服逻辑

Default value: false
Acceptable value: true false
Categories: Optimization Experimential

optimizeTeleport

仅1.17及1.18有此功能

优化玩家传送逻辑

Default value: false
Acceptable value: true false
Categories: Optimization Experimential

commandLogger

这个规则可以记录每一个玩家执行的每一个指令

CommandLogger.json配置文件可以配置白名单、黑名单等，修改配置文件后应执行/commandlogger reload指令热重载

Default value: false
Acceptable value: true false
Categories: Command Feature

commandLoggerBroadcastToPlayer

commandLogger中记录的指令会被转发到哪些玩家？

Default value: false
Acceptable value: true false ops
Categories: Command

dropperCrashFix

修复了方块实体替换导致投掷器激活时崩服的bug

这个bug的发现人是玩家kygo_life，他曾经在B站发了一个解释，不过被删掉了。

这个bug的触发流程大致如下：首先建造一个类似于物品分身的结构，只不过将箱子换成潜影盒（可为空），此时打开活板门，打掉潜影盒，此时更新抑制会被触发，然后在原本潜影盒的位置上放置一个投掷器，然后用红石信号（如拉杆）触发此投掷器即可崩档。

本bug在1.17.1经测试可用，其他版本未测试。

大致原理：

有点像方块实体替换，潜影盒被打掉后因为触发了更新抑制，所以虽说潜影盒方块被打掉了，但是方块实体仍保留
投掷器方块被放置，方块是投掷器，方块实体仍为潜影盒
触发时，那个投掷器的DropperBlock.dispense(...)方法会被调用，而那个方法有这样一段代码：（这行代码在yarn1.17.1、1.18.2、1.19.3、1.20.1完全相同）

DispenserBlockEntity dispenserBlockEntity = (DispenserBlockEntity)blockPointerImpl.getBlockEntity();
                                                ^^^^^^^^^^
                                               进行了一次强转

所以在强转时抛出ClassCastException，崩服甚至崩档（
Default value: false
Acceptable value: true false
Categories: BugFix

optimizeFakePlayerSpawn

如果你的服务器连接mojang服务器的时间长，spawn假人的时候就会卡顿一会，此规则强制所有假人使用离线uuid，解决这一问题（但是也许引发新的问题

Default value: false
Acceptable value: true false
Categories: Optimization

cceSuppressionCrashFix

防止cce更新抑制器导致服务器崩溃，详情请看Void0的视频

实验性规则

Default value: false
Acceptable value: true false
Categories: BugFix Experimential

removeAllCurseOfBindingArmorWhenPlayerDeadInWall

顾名思义，当玩家窒息死亡时移除所有绑定诅咒盔甲 ~~腐竹再也不用用指令移除绑定诅咒南瓜头了~~

Default value: false
Acceptable value: true false
Categories: Feature

customItemDiscardTime

自定义物品消失时间

Default value: false
Acceptable value: true false
Categories: Feature

allowBlockUpdateLogger

由于blockUpdate记录器可能导致性能问题，所以增加了一个规则allowBlockUpdateLogger，如果此规则禁用，所有玩家不论是否订阅了本记录器都不会受到方块更新的通知，并且本规则默认禁用。
若无需使用blockUpdate，强烈建议禁用

Default value: false
Acceptable value: true false
Categories: Feature Optimization

disallowRedstoneWireConnectsToOpenTrapdoor

仅限1.20版本及以上

如果你想在1.20使用音符盒极简抑制器，这可能能帮助你

Default value: false
Acceptable value: true false
Categories: Feature

removeBats

不再生成蝙蝠

Default value: false
Acceptable value: true false
Categories: Feature

指令

player xxx tp

tp到一个人，可以使用commandTpToFakePlayer allowTpToRealPlayer规则管理此指令

player xxx tphere

把一个人tp到自己，可以使用commandTpHereFakePlayer allowTpHereRealPlayer规则管理此指令

list -advance

显示每一个玩家的详细信息，包括uuid，游戏模式等

tpmanager

tpmanager tp whitelist add xxx 将前缀xxx添加到tp白名单
tpmanager tp blacklist add xxx 将前缀xxx添加到tp黑名单
tpmanager tphere whitelist add xxx 将前缀xxx添加到tphere白名单
tpmanager tphere blacklist add xxx 将前缀xxx添加到tphere黑名单
remove就是移除后缀，以此类推 ~~我都说这么细了，应该都能理解吧awa~~

crash

顾名思义 ~~别问我有什么用，我猜在切完光照更新抑制刷怪塔之后这个命令应该有点用~~
打完/crash之后需要再打/crash confirm才会崩服

记录器

disk

实时查看硬盘使用情况（HUD Logger，按Tab在玩家列表可查看）

updateSuppression

仅1.17和1.18

记录每一次更新抑制

cceSuppressionCrash

CCE更新抑制器崩溃记录，类似于carpet的updateSuppressedCrash

blockUpdate

由于本记录器可能导致性能问题，所以增加了一个规则allowBlockUpdateLogger，如果此规则禁用，所有玩家不论是否订阅了本记录器都不会受到方块更新的通知，并且本规则默认禁用。
若无需使用blockUpdate，强烈建议禁用allowBlockUpdateLogger规则

记录所有方块更新

OptiJava/OptCarpetAddition