https://github.com/xelsplugins/xelstweaks
Modular Dalamud tweak hub for small quality-of-life changes.
https://github.com/xelsplugins/xelstweaks
csharp dalamud dalamud-plugin dotnet ffxiv final-fantasy-xiv tweaks xivlauncher
Last synced: 12 days ago
JSON representation
Modular Dalamud tweak hub for small quality-of-life changes.
- Host: GitHub
- URL: https://github.com/xelsplugins/xelstweaks
- Owner: XelsPlugins
- Created: 2026-05-16T08:47:53.000Z (28 days ago)
- Default Branch: main
- Last Pushed: 2026-05-16T13:13:13.000Z (27 days ago)
- Last Synced: 2026-05-16T13:48:44.881Z (27 days ago)
- Topics: csharp, dalamud, dalamud-plugin, dotnet, ffxiv, final-fantasy-xiv, tweaks, xivlauncher
- Language: C#
- Homepage: https://raw.githubusercontent.com/XelsPlugins/XelsDalamudRepo/main/pluginmaster.json
- Size: 1.16 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# XelsTweaks
XelsTweaks is a modular Dalamud tweak hub for opt-in interface and utility fixes.
The first version contains the plugin shell, config window, tweak manager, and Auto Login tweak.
## Build
```bash
dotnet restore XelsTweaks/XelsTweaks.csproj
dotnet build XelsTweaks/XelsTweaks.csproj -c Release -p:EnableWindowsTargeting=true
```
On Linux, make sure Dalamud dev assemblies are available at `$DALAMUD_HOME` or `$HOME/.xlcore/dalamud/Hooks/dev`.
## Installation
Add the following URL to Dalamud's custom plugin repositories:
```text
https://raw.githubusercontent.com/XelsPlugins/XelsDalamudRepo/main/pluginmaster.json
```
Stable and testing builds are published manually. Testing builds require Dalamud's plugin testing versions option.
## Commands
- `/xelstweaks` or `/xt` opens the config window.
- `/xelstweaks list` prints registered tweak IDs.
- `/xelstweaks on ` enables a tweak.
- `/xelstweaks off ` disables a tweak.
- `/xelstweaks toggle ` toggles a tweak.
The same subcommands work with `/xt`.
## Adding Tweaks
1. Add a class under `XelsTweaks/Tweaks//`.
2. Inherit from `TweakBase`.
3. Override `OnEnable`, `OnDisable`, and optionally `DrawConfig`.
4. Register it in `TweakManager.RegisterTweaks`.