客户端配置文件

什么是客户端配置文件？

客户端配置文件 位于客户端 .minecraft/config 内，在这里你可以对自己的客户端做出一些更改，使得你的客户端更具有特色。

GermMod.cfg

# Configuration file

settings {
    # 在开启更多动作时
    # 展示时装小臂
    # 因为时装并未有小臂骨骼，目前并不能完美兼容
    # 开启此选项将隐藏胳膊显示时装
    # 否则会隐藏胳膊时装显示胳膊
    B:armorSkinArm=true

    # 是否开启自动奔跑
    B:autoSprint=true

    # 开启切换人称的过渡动画
    B:changePersonTransformAnimation=true

    # 客户端标题
    S:clientTitle=Minecraft[1.12.2] (Powered by GermMC)

    # 客户端版本标识，会在连接服务端时上报给GermPlugin
    S:clientVersion=pc-vlatest

    # 自动更新检查地址
    # 如果有自己的更新服务器，可以改成自己的地址
    S:updaterServer=

    # 关闭摄像机受伤效果
    B:disableCameraHurtEffect=false

    # 取消萌芽字体的渲染
    # 关闭后无法使用①RGBA颜色功能②无法使用字体替换图片功能
    B:disableGermFont=false

    # 是否关闭更多动作
    B:disableMoreBends=false

    # 设置为true关闭玩家攻击准备动作
    B:disablePlayerAttackReady=false

    # 是否关闭萌芽引擎的玩家渲染器
    B:disablePlayerRenderer=false

    # 是否关闭玩家的刀光渲染器
    B:disablePlayerSwordRenderer=false

    # 是否完全禁用拖动窗口大小
    B:disableResize=false

    # 是否关闭时装功能
    B:disableSkin=false

    # 是否开启类似时装工坊中的时装武器覆盖在原版钻石剑中的逻辑
    B:enableArmorSkinOverride=false

    # 开启万向跑后是否在玩家和鼠标交互时
    # 先转向相机的朝向方向再触发交互
    # 此选项更适合远程武器打开，可以使用dos动态控制
    # updateClient`<->`engineConfig@enableTurnSteeringRun@true/false
    B:enableAttackTurnCamera=true

    # 开启渲染实体身上的箭头
    B:enableArrowLayer=true

    # 开启聊天记录缓存
    # 可以在重启客户端后依然可以上下翻看历史记录
    B:enableChatHistoryCache=true

    # true启用沉浸式第三人称镜头
    # false使用经典的第三人称视角
    # DOS控制: updateClient`<->`engineConfig@enableImmersiveThirdPersonCamera@true/false
    B:enableImmersiveThirdPersonCamera=false

    # 万向跑，开启后第三人称将由WASD控制身体方向
    # 镜头可以随意旋转看向自己的全身
    # 跑步的时候按下ALT可以开启自由视角
    B:enableTurnSteeringRun=true

    # 万向跑控制模式，仅在 enableTurnSteeringRun 开启时生效
    # mouse：鼠标自由控制镜头
    # keyboard：键盘控制转向，鼠标可小范围调整视角并柔和回中
    S:turnSteeringControlMode=mouse

    # 修复Citizens的NPC会在Tab中间歇式闪现
    B:fixCitizenNpcFlickeringInTab=false

    # 开启修复高脚草影响玩家视口
    B:fixHighGrassInfluenceViewport=false

    # 字体的加载精度(9的倍数)
    # 可以双击打开ttf文件，会显示支持的精度列表
    # 格式为 字体名:精度 精度越大显示越清晰，同时也更占据内存
    # 如果不在此填写，默认精度为27
    S:fontFine <
        default:27
     >

    # 是否强制玩家使用alex的小臂模型
    # 前提是开启萌芽玩家渲染器
    B:forceAlexArm=false

    # 强制界面尺寸
    # 填2是中,-1为不强制
    I:forceGuiScale=-1

    # 当玩家被墙挡住的时候完全隐藏名字
    B:hidePlayerNameWhenBlockedWall=false

    # 物品冷却时显示的冷却文本
    # 颜色符号用§
    # 填写none为不显示
    S:itemCooldownDisplay=§e%ss

    # 使用RGBA字符颜色功能时匹配什么字符
    I:matchCharForRGBA=35

    # 粒子路径前缀，默认是 effect/particles/
    # 如果想直接使用 Snowstorm 的 VSCode 拓展加载粒子贴图，建议改为 particles/
    S:particlePathPrefix=effect/particles/

    # 服务端事件GermPlayerPointToEntityEvent触发的范围
    # Min: 4.0
    # Max: 32.0
    D:playerPointToEntityEventTriggerRange=4.0

    # 预加载，目前支持UI图片文件,音效文件,基岩粒子文件
    # 为防止第一次加载图片时会卡顿，会直接在客户端启动的时候加载进内存
    # 对在服务端设置密码的材质包内的图片文件无效
    # 其中特殊占位符*代表仅文件夹内的所有贴图，**包括子文件夹中所有的贴图
    # 例如 "textures/gui/*"
    S:preloadResources <
        textures/misc/logo.png
     >

    # 在鼠标指到时装物品时，开启时装预览框
    B:previewSkinEnable=false

    # 在槽位中预览时装
    B:previewSkinInSlot=true

    # 在槽位中预览时旋转时装
    # 前提是开启了 previewSkinInSlot 
    B:previewSkinRotateInSlot=true

    # 允许接收MOD输出消息的玩家名字
    # 填写 @Everyone 是所有人都接收
    # 填写 @Creative 为创造的玩家接收
    # 填写 @None 为谁都不接收
    # 填写固定的玩家名字可以指定玩家接收
    S:receiveLogPlayerName=@Everyone

    # 客户端资源版本，会在连接服务端时上报给GermPlugin
    # 服务端可以通过 Config.yml 中的 Settings.resourceVersionCheck 要求最低版本
    I:resourceVersion=1

    # 可同时播放的普通音效数量
    I:soundNormalCount=28

    # 可同时播放的流媒体音效数量
    I:soundStreamingCount=4

    # 是否开启聊天平滑出现
    B:chatSmooth=true

    # 是否渲染玩家的CustomName
    # 这样在服务器端给玩家设置CustomName就可以显示了
    # 设置了之后别忘了设置customvisible为true
    B:renderPlayerCustomName=false

    # 替换原版的字体渲染器
    # 格式为 TTF字体名:字体大小 
    # 一般来说，字体大小设置为12可以与原版字体比较吻合
    # 可以双击打开ttf文件，会显示支持的精度列表
    # 因不同字体存在差异，请自行找到合适的字体大小进行替换
    S:replaceFontRenderer=null

    # 开启后当玩家不是第一人称的时候可以看到自己的tag
    B:showPlayerTagToSelf=false

    # 在隐身药水下不渲染时装和盔甲等
    B:visiblePotionDisableLayer=false

    # MC窗口的比率(w/h),-1为禁用,推荐使用16:9的比例也就是1.777
    # 这样设置后窗口的大小只允许为该比率
    # 这样GUI界面就不会因为玩家乱拖而乱掉了
    D:windowRatio=-1.0
}

客户端版本与资源版本

clientVersion 和 resourceVersion 是萌芽连接服务端时会上报给 GermPlugin 的两个字段：

配置	作用
`clientVersion`	客户端版本标识，可用于区分整包、渠道、启动器或测试客户端。包含 `dev` 时会被视为开发/测试客户端。
`resourceVersion`	客户端资源版本号，对应 `EngineConfig.resourceVersion`。建议每次发布新的正式客户端资源包、加密资源或客户端本地 source 时递增。

服务端可以通过 Config.yml 中的 Settings.resourceVersionCheck 要求最低 resourceVersion。如果玩家客户端上报的资源版本低于要求，会被踢出并显示 Settings.resourceVersionMsg。

更多资源版本、开发客户端和 source 下发过滤说明见客户端资源版本与连接信息。

资源与更新配置

这些字段通常在制作客户端整包、资源包或启动器分发时会用到：

配置	作用
`preloadResources`	客户端启动时预加载指定 UI 图片、音效、基岩粒子文件。`` 表示当前文件夹内文件，`*` 表示包含子文件夹。
`updaterServer`	自动更新检查地址；有自建更新服务时填写。
`particlePathPrefix`	基岩粒子文件路径前缀，默认 `effect/particles/`。使用 Snowstorm 工作流时可改为 `particles/`。

渲染与体验开关

常见客户端表现开关如下：

配置	作用
`disableGermFont`	关闭萌芽字体渲染；关闭后 RGBA 字符颜色和字体替换图片不可用。
`replaceFontRenderer`	替换原版字体渲染器，格式为 `TTF字体名:字体大小`。
`fontFine`	TTF 字体加载精度，精度越大越清晰，也更占内存。
`disableResize`	禁止拖动窗口大小。
`windowRatio`	限制 MC 窗口比例，`-1` 表示不限制。
`forceGuiScale`	强制界面尺寸，`-1` 表示不强制。
`receiveLogPlayerName`	控制哪些玩家能收到 MOD 输出消息。
`clientTitle`	修改客户端窗口标题。
`enableChatHistoryCache`	开启聊天记录缓存，重启客户端后仍可上下翻看历史消息。
`chatSmooth`	是否开启聊天平滑出现。
`soundNormalCount`	可同时播放的普通音效数量。
`soundStreamingCount`	可同时播放的流媒体音效数量。
`disableCameraHurtEffect`	关闭摄像机受伤效果。
`changePersonTransformAnimation`	开启切换人称的过渡动画。
`matchCharForRGBA`	使用 RGBA 字符颜色功能时匹配的起始字符，默认 `#`。

玩家渲染与操作开关

这些字段会影响玩家渲染、时装、动作和交互：

配置	作用
`disablePlayerRenderer`	关闭萌芽玩家渲染器。
`disableSkin`	关闭时装功能。
`disableMoreBends`	关闭更多动作。
`disablePlayerAttackReady`	关闭玩家攻击准备动作。
`disablePlayerSwordRenderer`	关闭玩家刀光渲染器。
`enableArmorSkinOverride`	开启类似时装工坊中时装武器覆盖原版钻石剑的逻辑。
`armorSkinArm`	更多动作开启时，控制时装小臂和原胳膊显示关系。
`forceAlexArm`	强制玩家使用 Alex 小臂模型。
`visiblePotionDisableLayer`	玩家隐身时不渲染时装和盔甲等图层。
`enableArrowLayer`	渲染实体身上的箭头。
`previewSkinEnable`	鼠标指向时装物品时显示时装预览框。
`previewSkinInSlot`	在槽位中预览时装。
`previewSkinRotateInSlot`	槽位预览时让时装旋转。
`itemCooldownDisplay`	物品冷却时显示的文本，填 `none` 不显示。
`renderPlayerCustomName`	渲染服务端设置的玩家 `CustomName`。
`hidePlayerNameWhenBlockedWall`	玩家被墙挡住时完全隐藏名字。
`showPlayerTagToSelf`	非第一人称时能看到自己的 tag。
`autoSprint`	开启自动奔跑。
`playerPointToEntityEventTriggerRange`	服务端 `GermPlayerPointToEntityEvent` 触发范围。
`fixCitizenNpcFlickeringInTab`	修复 Citizens NPC 在 Tab 中间歇闪现。
`fixHighGrassInfluenceViewport`	修复高脚草影响玩家视口。

沉浸式第三人称镜头

enableImmersiveThirdPersonCamera 用来开启萌芽控制的沉浸式第三人称镜头。开启后，客户端会使用更平滑的第三人称跟随、移动惯性和镜头偏移效果。

客户端本地配置：

settings {
    B:enableImmersiveThirdPersonCamera=true
}

服务端也可以通过 DOS 为指定玩家动态控制沉浸式第三人称镜头开关：

updateClient<->engineConfig@enableImmersiveThirdPersonCamera@true

注意：

该功能只改变客户端镜头表现，不会改变玩家实际坐标，也不会影响服务端移动判定。
角色活动区、镜头偏移和跟随参数由服务端 Config.yml 中的 ClientOptions.PlayerPerspective 统一控制。

万向跑

enableTurnSteeringRun 开启后，第三人称由 WASD 控制身体方向，镜头可以自由观察角色。

配置	作用
`enableTurnSteeringRun`	开启万向跑。
`turnSteeringControlMode`	万向跑控制模式，`mouse` 为鼠标自由控制镜头，`keyboard` 为键盘控制转向。
`enableAttackTurnCamera`	开启万向跑后，玩家交互前先转向相机朝向。适合远程武器。

运行时可以通过 DOS 调整：

updateClient<->engineConfig@turnSteeringControlMode@mouse
updateClient<->engineConfig@turnSteeringControlMode@keyboard

rfp2.cfg

# Configuration file

##########################################################################################################
# compatability
#--------------------------------------------------------------------------------------------------------#
# 物品设置 Real First Person 2
##########################################################################################################

compatability {
    # Disables the mod when sneaking.
    # 当潜行的时候停止使用第一人称
    B:"Disable when sneaking"=false

    # Disables the mod when swimming.
    # 当游泳的时候停止使用真实第一人称
    B:"Disable when swimming"=true

    # Vanilla arms are used when holding one of these items.
    # Needed for compasses and maps, stops big items blocking the view.
    # Note: Not case sensitive, accepts simple item names and regex patterns:
    # .* = wildcard, ^ = match beginning of name, $ = match end of name.
    # 手持以下物品时关闭真实第一人称
    S:"Held Item Conflicts" <
        minecraft:filled_map
        .*compass$
        tconstruct:.*bow
        tconstruct:battlesign
        thermalfoundation:shield_.*
     >

    # Disables rendering safety checks. May enable compatibility with mods that cause rendering exceptions, but cannot guarantee that the game will be stable.
    B:"Ignore rendering errors (not recommended)."=false

    # Mod temporarily disables when riding one of these mounts.
    # Stops legs clipping through minecarts.
    # Note: Not case sensitive, accepts simple item names and regex patterns.
    # .* = wildcard, ^ = match beginning of name, $ = match end of name.
    S:"Mount Conflicts" <
        .*minecart.*
     >

    # Enforces a more aggressive version of the swimming checks.
    # 增强游泳检测提高准确性
    B:"Use aggressive swimming checks"=false

    # Switches to vanilla arms when *any* item is held, not just conflict items.
    B:"Use vanilla arms when holding any item"=false
}


##########################################################################################################
# preferences
#--------------------------------------------------------------------------------------------------------#
# 偏好设置 Real First Person 2
##########################################################################################################

preferences {
    # Enables/disables head turning at startup
    # 是否开启真实的头部转向(身子和相机方向会有角度差)
    # Default: false
    B:"Enable Head Turning"=false

    # Enables/disables mod at startup.
    # 是否开启真实第一人称
    B:"Enable Mod"=false

    # 真实第一人称时隐藏玩家的某些肢体
    # 设置0为不隐藏
    # 设置1为隐藏除了手以外的部位
    # 设置2为隐藏所有部位
    # 设置3为隐藏除了小臂以外的部位
    # 设置4为隐藏除了手意外的部位，并且跟随镜头渲染
    # 设置5为隐藏玩家所有部位，并且跟随镜头渲染
    I:"Player Model Hide Limbs"=0

    # How far behind the camera to put the first person player model
    # Default: 0.55
    # 相机与玩家的距离
    # Min: 0.0
    # Max: 2.0
    D:"Player Model Offset"=0.550000011920929
}

什么是客户端配置文件？​

GermMod.cfg​

客户端版本与资源版本​

资源与更新配置​

渲染与体验开关​

玩家渲染与操作开关​

沉浸式第三人称镜头​

万向跑​

rfp2.cfg​