mirror of
https://github.com/mleem97/gregWiki.git
synced 2026-04-11 03:29:19 +02:00
526a9629ae
- Revised the documentation layout to reflect updated paths for various sections, including workspace, framework, plugins, mods, tools, guides, releases, reference, contributors, roadmap, topics hub, meta, and legacy. - Adjusted links to ensure they point to the correct files, enhancing navigation and accessibility within the documentation. - Improved descriptions in the Mods and Plugins sections to clarify the distinction between gameplay mods and framework plugins. This commit enhances the overall structure and usability of the documentation.
105 lines
4.2 KiB
Markdown
105 lines
4.2 KiB
Markdown
---
|
|
title: FMF.HexLabelMod
|
|
sidebar_label: FMF.HexLabelMod
|
|
---
|
|
|
|
<!-- markdownlint-disable MD060 -->
|
|
|
|
`mods/FMF.Mod.HexLabelMod`
|
|
|
|
## Purpose
|
|
|
|
Standalone MelonLoader mod for **Data Center** (Waseku) that overlays the hex color code of each `CableSpinner` and `Rack` directly in-world, so you can identify cable and rack colors at a glance without opening any menu.
|
|
|
|
Rewritten from the former root `HexLabelMod` for the FrikaModdingFramework workflow, now running fully standalone.
|
|
|
|
## Requirements
|
|
|
|
| Dependency | Notes |
|
|
| --- | --- |
|
|
| [MelonLoader](https://melonwiki.xyz/) | With generated IL2CPP assemblies |
|
|
|
|
This mod runs standalone and does **not** require FMF runtime APIs.
|
|
|
|
## Installation
|
|
|
|
1. Drop `FMF.HexLabelMod.dll` into your `Mods/` folder.
|
|
2. Launch the game — the config file is created automatically on first run at:
|
|
|
|
```text
|
|
UserData/hexposition.cfg
|
|
```
|
|
|
|
## Configuration
|
|
|
|
Edit `UserData/hexposition.cfg` to adjust label positioning and font sizes. The file is auto-generated with defaults on first launch and regenerated if any keys are missing.
|
|
|
|
```ini
|
|
# Hex Label Position Config
|
|
# File: UserData/hexposition.cfg
|
|
# Edit values, then restart game.
|
|
|
|
# Spinner (UI text near cable spool)
|
|
spinner_offset_x=0
|
|
spinner_offset_y=-6
|
|
spinner_font_min=1.8
|
|
spinner_font_max=6.2
|
|
spinner_font_scale=0.24
|
|
|
|
# Rack (world-space text at rack back-right-bottom)
|
|
rack_offset_right=-0.03
|
|
rack_offset_back=0.06
|
|
rack_offset_down=-0.02
|
|
rack_font_size=42
|
|
rack_character_size=0.05
|
|
rack_scale=1
|
|
```
|
|
|
|
### Config Keys
|
|
|
|
| Key | Type | Default | Description |
|
|
| --- | --- | --- | --- |
|
|
| `spinner_offset_x` | float | `0` | Horizontal offset relative to the source label |
|
|
| `spinner_offset_y` | float | `-6` | Vertical offset relative to the source label |
|
|
| `spinner_font_min` | float | `1.8` | Minimum auto-size font size (TMPro) |
|
|
| `spinner_font_max` | float | `6.2` | Maximum auto-size font size (TMPro) |
|
|
| `spinner_font_scale` | float | `0.24` | Scale factor applied to the source label's font size |
|
|
| `rack_offset_right` | float | `-0.03` | World-space offset along rack's right axis |
|
|
| `rack_offset_back` | float | `0.06` | World-space offset along rack's back axis |
|
|
| `rack_offset_down` | float | `-0.02` | World-space offset along rack's down axis |
|
|
| `rack_font_size` | int | `42` | Font size for the world-space `TextMesh` label |
|
|
| `rack_character_size` | float | `0.05` | Character size for the world-space `TextMesh` label |
|
|
| `rack_scale` | float | `1` | Uniform world-space scale of the rack label object |
|
|
|
|
## Live Reload *(restricted)*
|
|
|
|
Pressing **Ctrl+F1** toggles live config reload (6-second interval), allowing you to tune label positions without restarting the game. This feature is restricted to a specific Steam account and will silently do nothing for all other users.
|
|
|
|
## Build
|
|
|
|
```powershell
|
|
dotnet build .\mods\FMF.Mod.HexLabelMod\FMF.HexLabelMod.csproj
|
|
```
|
|
|
|
Output lands in the standard MelonLoader `Mods/` folder as configured in the `.csproj`.
|
|
|
|
## How It Works
|
|
|
|
1. **Startup** — The mod defers full initialization until MelonLoader's `Latest.log` confirms the Steam runtime is ready (SteamID or Steam marker detected).
|
|
2. **Spinner labels** — Every `CableSpinner` gets a cloned `TextMeshProUGUI` label injected into its UI hierarchy, displaying the resolved hex code in white. Color is read from `rgbColor`, then from the `_BaseColor`/`_Color` material property as fallback.
|
|
3. **Rack labels** — Every `Rack` gets a world-space `TextMesh` label positioned at its back-right-bottom corner, facing away from the rack front.
|
|
4. **Scan loop** — Active spinners and racks are re-checked every 1.5 seconds to catch newly spawned objects.
|
|
5. **Harmony patch** — `CableSpinner.Start` is patched to inject the label immediately on spawn, before the first scan cycle runs.
|
|
|
|
## Notes
|
|
|
|
- Original gameplay behavior is unaffected.
|
|
- This mod runs from `mods/FMF.Mod.HexLabelMod` and no longer from the repository root.
|
|
- The config file is fully rewritten if any expected keys are missing (for example, after an update adds new keys).
|
|
- FMF assembly presence is no longer required as a startup gate.
|
|
|
|
## Sources
|
|
|
|
- Module path: `mods/FMF.Mod.HexLabelMod`
|
|
- Relatedocs: [`Standalone Mods`](/wiki/legacy/wiki-import/StandaloneMods)
|