TweakLite

TweakLite

TweakLite is a lightweight Fabric mod that provides a set of configurable client/server-side tweaks to improve gameplay experience.

by
102 Downloads
fabricgame-mechanics
Rent Server with this Mod

About this Mod

TweakLite

TweakLite is a lightweight Fabric mod that provides a set of configurable client/server-side tweaks to improve gameplay experience.

Quick Overview

  • Use the in-game configuration interface (Hotkey: X + K, by default) to open and adjust all settings.
  • Configuration is divided into three groups: "Generic", "Survival", and "Creative"; some settings on the Survival tab will be synchronized with the server.

Configuration Items

Survival Tab Configuration (Client & Server)

  • player_attack_range (Player Attack Range)

    • Default: 3
    • Range: 0 — 128
    • Description: Adjusts the player's attack distance (melee/hit range).
  • player_block_range (Block Interaction Range)

    • Default: 5
    • Range: 0 — 64
    • Description: Adjusts the maximum distance for player block interactions (placing/mining/using).
  • noPumpkinBlur (Remove Carved Pumpkin Overlay)

    • Default: false
    • Type: Boolean
    • Description: Whether to remove the screen overlay effect when wearing a carved pumpkin.
  • sheared_goat_horn (Shear Goat Horns)

    • Default: false
    • Type: Boolean
    • Description: Whether to enable shearing goat horns with shears.

Entity Scaling Configuration

  • player_scale_size (Player Scale Size)

    • Default: 1.0
    • Range: 0 — 50
    • Description: Scales the player model size proportionally (1.0 = normal size).
  • entity_scale_size (Entity Scale Size)

    • Default: 1.0
    • Range: 0 — 50
    • Description: Scales the default display size of other entities proportionally.

Creative Tab Configuration (Client-only)

  • copy_spawn_egg_nbt (Copy Entity NBT to Spawn Egg)
    • Default: false
    • Type: Boolean
    • Description: When enabled in Creative mode, use Ctrl + Middle Click to copy target entity NBT to a spawn egg.

Generic Configuration / Hotkeys

  • openConfigGui (Open Configuration GUI Hotkey)

    • Default Key: X + K
    • Description: Press this key combination in-game to open the TweakLite configuration GUI, where all available options can be adjusted.
  • apply_player_scale_key (Apply Player Scale Hotkey)

    • Default Key: C
    • Description: Press this hotkey to apply player_scale_size to the current player.
  • apply_entity_scale_key (Apply Entity Scale Hotkey)

    • Default Key: V
    • Description: Press this hotkey to apply entity_scale_size to the selected entity.

Usage Examples and Notes

  • It is recommended to test and verify settings in a single-player or test server before using them on a production server, as some Survival tab settings require server-side support to take effect or may be overridden.
  • Extreme values for attack/interaction ranges may affect gameplay experience or cause detection/rendering issues; please use caution with values greater than 10.

===============================================================================

TweakLite

TweakLite 是一个轻量级的 Fabric mod,提供一组可配置的客户端/服务端微调(tweaks),以改善玩法体验。

快速概览

  • 在游戏内通过配置界面(Hotkey:X + K,默认)打开并调整所有设置。
  • 配置分为“通用(Generic)”、“生存(Survival)”和“创造(Creative)”三组;生存页的部分设置会与服务端同步。

配置项

生存页(Survival)配置 —(客户端 & 服务器端)

  • player_attack_range(玩家攻击范围)

    • 默认值:3
    • 范围:0 — 128
    • 说明:调整玩家的攻击距离(近战/判定范围)。
  • player_block_range(方块交互距离)

    • 默认值:5
    • 范围:0 — 64
    • 说明:调整玩家与方块交互(放置/挖掘/使用)的距离上限。
  • noPumpkinBlur(移除雕刻南瓜屏幕覆盖)

    • 默认值:false
    • 类型:布尔
    • 说明:是否去除佩戴雕刻南瓜时的屏幕效果。
  • sheared_goat_horn(剪刀可剪山羊角)

    • 默认值:false
    • 类型:布尔
    • 说明:是否启用剪刀可剪山羊角。

实体缩放配置

  • player_scale_size(玩家缩放比例)

    • 默认值:1.0
    • 范围:0 — 50
    • 说明:按比例缩放玩家模型大小(1.0 表示正常大小)。
  • entity_scale_size(实体缩放比例)

    • 默认值:1.0
    • 范围:0 — 50
    • 说明:按比例缩放其他实体的默认显示大小。

创造页(Creative)配置 —(仅客户端)

  • copy_spawn_egg_nbt(创造模式复制实体 NBT 到刷怪蛋)
    • 默认值:false
    • 类型:布尔
    • 说明:在创造模式下启用后,可使用Ctrl+鼠标中键将目标实体的 NBT 复制到刷怪蛋。

通用(Generic)配置 / 热键

  • openConfigGui(打开配置界面热键)

    • 默认键:X + K
    • 说明:在游戏内按此组合键打开 TweakLite 的配置 GUI,所有可用选项均可在 GUI 中调整。
  • apply_player_scale_key(应用玩家缩放的热键)

    • 默认键:C
    • 说明:按下此热键可对当前玩家应用 player_scale_size
  • apply_entity_scale_key(应用实体缩放的热键)

    • 默认键:V
    • 说明:按下此热键可对选中实体应用 entity_scale_size

使用示例与注意事项

  • 建议在单人或测试服务器上先调整并确认设置的影响再在正式服务器使用,因部分生存页设置需要服务器端支持才能生效或被覆盖。
  • 攻击/交互距离的极端值可能影响体验或导致显示/判定异常,请谨慎使用大于 10 的极限距离。

Available Versions

1.0.3release
MC 1.21.9, 1.21.10fabric
May 27, 2026
1.0.2release
MC 1.21.9, 1.21.10fabric
January 12, 2026
TweakLite 1.0.1release
MC 1.21.9, 1.21.10fabric
November 21, 2025
TweakLite 1.0.0release
MC 1.21.9, 1.21.10fabric
November 21, 2025

How to Install TweakLite on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.10).

3

Install Mod

Open the mod browser in the dashboard and search for "TweakLite". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabric

Minecraft Versions

1.21.10, 1.21.9

Server-side

Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

TweakLite server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.10). You can switch loaders with one click in the panel.

Is TweakLite compatible with fabric?

TweakLite officially supports fabric for Minecraft 1.21.10, 1.21.9. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with TweakLite – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if TweakLite consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install TweakLite with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Required

Supported Versions

1.21.101.21.9