L's Advanced Bust Customizer

L's Advanced Bust Customizer is a highly configurable character appearance and physics mod designed to give players detailed control over bust shape, proportions, appearance, and dynamic movement directly in-game.

Instead of using a single fixed model, the mod provides a complete visual customization interface with real-time character preview, independent parameter adjustment, physics controls, armor preview support, presets, and multiplayer synchronization.

## Quick Start

Press **G** in-game to open the L's Advanced Bust Customizer panel.

From the customization panel, you can adjust appearance, proportions, detailed model settings, physics, presets, armor preview, and other available options in real time.

Main Features

Advanced Appearance Customization

The bust model can be adjusted through multiple independent parameters rather than a simple size slider.

Available controls include:

• Overall Size
• Width
• Height
• Projection
• Spacing
• Position and proportion adjustment
• Individual parameter reset
• Global reset
• Real-time visual preview

This allows players to create anything from subtle proportions to much more stylized character models.

The system is designed around precise numerical controls, so every setting can be fine-tuned rather than relying only on predefined models.

---

Shape System

The mod includes selectable bust shapes.

Current shape options include:

• Block

Shape selection is separated from the main appearance settings so additional shapes and presets can be expanded independently.

---

Detailed Appearance Controls

Bust rendering can be enabled or disabled directly from the configuration screen.

The appearance system also supports automatic color matching based on the player's current skin.

This allows the model to integrate naturally with different Minecraft skins without requiring separate textures for every character.

---

Nipple Customization

A separate customization section is provided for additional model details.

Available adjustments include:

• Enable / Disable
• Automatic skin-based color
• Custom appearance controls
• Size
• Width
• Height
• Projection
• Horizontal position

These values can be adjusted independently from the main bust model.

The goal is to allow detailed model customization while keeping all settings accessible through the same in-game editor.

---

Dynamic Physics System

The mod includes configurable bust physics rather than using a fixed animation.

Physics can be enabled or disabled and adjusted through several parameters:

• Strength — controls the overall amount of movement
• Stiffness — controls how resistant the model is to deformation and movement
• Damping — controls how quickly movement settles
• Gravity — controls the downward physical influence

This makes it possible to create anything from restrained movement to softer and more dynamic motion.

---

Independent Physics

The physics system supports an Independent mode.

When enabled, the left and right sides can use separate physics settings.

This allows individual adjustment instead of forcing both sides to behave identically.

For example, players can independently configure:

• Left-side physics
• Right-side physics
• Strength
• Stiffness
• Damping
• Gravity

This provides significantly more control than a single global physics multiplier.

---

In-Game Character Preview

The configuration screen includes a built-in 3D character preview.

You can:

• Drag to rotate the character
• Scroll to zoom
• Preview the model from different angles
• Preview movement
• Preview the currently equipped armor
• Adjust values while immediately seeing the result

This means most customization can be completed without repeatedly closing the menu and returning to third-person view.

---

Armor Preview and Compatibility

The editor includes an armor preview system.

Players can preview the current equipment directly inside the customization interface, making it easier to check how custom proportions interact with equipped armor.

The bust model is designed to work together with the player's normal character rendering rather than replacing the entire player model.

---

Preset System

The second page of the editor contains a dedicated preset section.

Presets are intended to make it easier to:

• Save commonly used configurations
• Quickly switch between different appearances
• Restore preferred proportions
• Experiment without losing previous settings

The preset system is separated from individual parameter controls to keep the main editor clean.

---

Built-In Controls

The editor provides convenient control buttons for configuration management:

• Reset — resets the current setting or section
• Reset All — restores all customization values
• Apply — applies the current configuration
• Done — saves and exits the editor

Individual parameters also include their own reset buttons, allowing one setting to be restored without affecting the rest of the configuration.

---

Multiplayer Support

L's Advanced Bust Customizer is designed with multiplayer visibility in mind.

Player customization data can be synchronized so supported appearance settings are visible to other players using the mod.

This allows each player to maintain their own customized character appearance rather than every client displaying the same configuration.

---

Designed for Fine Control

The main goal of L's Advanced Bust Customizer is not simply to add a different player model.

It is designed as a full character customization system.

Instead of choosing between only a few fixed presets, players can precisely control proportions, shape, appearance and physics and immediately preview the result inside Minecraft.

---

Current Core Systems

Appearance

• Overall size
• Width
• Height
• Projection
• Spacing
• Shape selection
• Automatic skin color matching

Detail Customization

• Enable / disable
• Size
• Width
• Height
• Projection
• Horizontal position
• Skin-following color

Physics

• Enable / disable
• Independent physics mode
• Strength
• Stiffness
• Damping
• Gravity
• Separate left/right configuration

Editor

• 3D live preview
• Mouse rotation
• Scroll zoom
• Animation preview
• Armor preview
• Multiple pages
• Per-setting reset
• Reset all
• Apply / save controls
• Preset system

---

中文介绍

L's Advanced Bust Customizer（L 的高级胸部定制器） 是一款专注于角色外观与动态物理效果的高度自定义 Minecraft Mod。

它并不是简单地给角色添加一个固定模型，而是提供了一套完整的 游戏内角色胸部定制系统，玩家可以自由调整胸部的尺寸、比例、形状、细节、颜色以及物理效果，并通过内置的 3D 角色预览实时查看最终效果。

## 快速开始

进入游戏后，按 **G 键** 打开 **L's Advanced Bust Customizer 高级胸部定制面板**。

你可以直接在面板中实时调整角色的外观、尺寸比例、模型细节、动态物理效果、预设、盔甲预览以及其他可用设置。

高级外观自定义

玩家可以分别调整多个参数：

• 整体大小
• 宽度
• 高度
• 前凸长度
• 胸部间距
• 比例与位置
• 独立参数重置
• 全部重置

每一个参数都可以独立调整，而不是只能通过一个简单的“大小”选项控制整个模型。

因此可以制作从较自然的比例到更加风格化的角色外观。

---

形状系统

Mod 提供独立的胸部形状选择功能。

目前包含：

• 方块 / Block

形状系统与尺寸调整功能相互独立，为以后增加更多形状和预设保留了扩展空间。

---

颜色与皮肤适配

胸部模型可以：

• 单独启用或关闭
• 自动跟随角色皮肤颜色
• 根据玩家当前 Skin 自动匹配外观

因此玩家更换 Minecraft 皮肤后，不需要重新制作单独贴图，也可以保持角色模型与皮肤风格一致。

---

细节自定义

Mod 内提供独立的细节设置页面，可以单独调整：

• 开启 / 关闭
• 自动跟随皮肤颜色
• 大小
• 宽度
• 高度
• 前凸程度
• 水平位置

这些参数与主体模型相互独立，因此可以进行更加细致的外观调整。

---

动态物理系统

Mod 内置可调节的动态物理效果。

物理系统不是固定动画，而是可以通过参数进行自定义：

• Strength / 强度
  控制整体运动幅度。

• Stiffness / 刚度
  控制模型对运动和形变的抵抗程度。

• Damping / 阻尼
  控制运动停止和回稳的速度。

• Gravity / 重力
  控制垂直方向的物理影响。

因此玩家可以根据自己的偏好制作偏稳定、偏柔和或者更加明显的动态效果。

---

左右独立物理

物理系统支持：

Independent / 独立模式

在该模式下，可以分别编辑左右两侧的物理参数。

也就是说：

• 左侧可以使用一套物理参数
• 右侧可以使用另一套物理参数

包括：

• 强度
• 刚度
• 阻尼
• 重力

不需要强制左右完全相同。

---

游戏内实时 3D 预览

Mod 自带完整的角色预览界面。

玩家可以直接：

• 鼠标拖动旋转角色
• 滚轮缩放角色
• 查看不同角度
• 预览角色动作
• 预览当前装备
• 一边修改参数一边实时观察效果

因此大部分设置都不需要反复退出菜单再切换第三人称查看。

---

盔甲预览

编辑器支持：

Preview Armor / 预览盔甲

可以直接显示角色当前装备，并检查自定义模型与装备后的实际视觉效果。

这对于调整较大的尺寸、前凸程度和不同角色比例时尤其有用。

---

预设系统

编辑器第二页提供独立的：

Presets / 预设

预设系统用于管理不同的角色配置，例如：

• 保存常用外观
• 快速切换不同设置
• 保存喜欢的比例
• 尝试新配置而不影响原来的方案

这样玩家不需要每次重新调整大量参数。

---

完整的配置管理

编辑界面提供：

• Reset — 重置当前部分
• Reset All — 重置全部参数
• Apply — 应用当前设置
• Done — 保存并退出

每个参数右侧同时拥有独立重置按钮，因此误调一个参数时不需要重置整个角色配置。

---

多人游戏支持

Mod 设计时考虑了多人游戏环境。

玩家的角色自定义配置可以进行同步，使安装该 Mod 的其他玩家也能够看到对应的角色外观。

这意味着每个玩家都可以拥有属于自己的个性化配置，而不是所有客户端使用同一种模型设置。

---

Mod 的核心定位

L's Advanced Bust Customizer 并不是一个单纯修改角色模型的 Mod，而是一套完整的 Minecraft 角色身体外观与物理自定义系统。

它的核心特点是：

高自由度、精细参数、实时预览、动态物理、独立配置与角色个性化。

玩家不需要接受一个作者预先设定好的固定模型，而是可以根据自己的角色、Skin、装备和个人喜好，自由设计最终外观。