ToxicMushroom/Penumbra
1
0
Fork 0
mirror of https://github.com/xivdev/Penumbra.git synced 2025-12-12 10:17:22 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions
FINAL FANTASY XIV modding, but actually good this time
2736 commits 12 branches 411 tags 14 MiB
Find a file
Ottermandias 861cbc7759 Add global EQP edits to always hide horns or ears.
2025-05-21 15:45:05 +02:00
.github/workflows Revert Dalamud staging on release, and update api level. 2025-03-28 14:10:52 +01:00
.idea/.idea.Penumbra/.idea Create enable/disable functions and clean up PR. 2021-10-19 11:30:08 +02:00
images New icon, newlines in repo.json 2021-10-08 18:56:56 +02:00
OtterGui@9aeda9a892 Fix clipping in meta edits. 2025-05-18 12:54:23 +02:00
Penumbra Add global EQP edits to always hide horns or ears. 2025-05-21 15:45:05 +02:00
Penumbra.Api@1465203967 Add some migration stuff. 2025-04-10 00:02:49 +02:00
Penumbra.CrashHandler Update for SDK. 2025-03-27 12:04:38 +01:00
Penumbra.GameData@b15c0f07ba Fix some issues with customization IDs and supported counts. 2025-05-19 17:15:29 +02:00
Penumbra.String@0e5dcd1a56 Update npc names. 2025-04-19 23:11:45 +02:00
schemas Add global EQP edits to always hide horns or ears. 2025-05-21 15:45:05 +02:00
.editorconfig Remove meta-default-value checking from TT imports, move it entirely to mod loads, and keep default-valued entries if other options actually edit the same entry. 2025-04-08 16:56:23 +02:00
.gitignore Upgrade to SDK-style .csproj file 2020-09-15 18:32:06 +02:00
.gitmodules Change SubModules to https 2023-10-05 20:29:34 +02:00
Penumbra.sln Add shape meta manipulations and rework attribute hook. 2025-05-15 17:46:53 +02:00
README.md Update README.md 2022-07-17 12:49:52 +02:00
repo.json [CI] Updating repo.json for testing_1.3.6.12 2025-05-19 15:17:54 +00:00

README.md

Penumbra

Penumbra is a runtime mod loader for FINAL FANTASY XIV, with a bunch of other useful features baked in:

  • No need to back up your install - mods don't touch game files
  • Disable and enable mods without restarting the game
  • Resolve conflicts between mods by changing mod order
  • Files can be edited and are often replicated in-game after a map change or closing and reopening a window

Support

Either open an issue here or join us in Discord.

Contributing

Contributions are welcome, but please make an issue first before writing any code. It's possible what you want to implement is out of scope for this project, or could be reworked so that it would provide greater benefit.

TexTools Mods

Penumbra has support for most TexTools modpacks however this is provided on a best-effort basis and support is not guaranteed. Built in tooling will be added to Penumbra over time to avoid many common TexTools use cases.

Installing

While this project is still a work in progress, you can use it by adding the following URL to the custom plugin repositories list in your Dalamud settings An image-based install (and usage) guide to do this is provided by unaffiliated user Serenity: https://reniguide.info/

  1. /xlsettings -> Experimental tab
  2. Copy and paste the repo.json link below
  3. Click on the + button
  4. Click on the "Save and Close" button
  5. You will now see Penumbra listed in the Available Plugins tab in the Dalamud Plugin Installer
  6. Do not forget to actually install Penumbra from this tab.

Please do not install Penumbra manually by downloading a release zip and unpacking it into your devPlugins folder. That will require manually updating Penumbra and you will miss out on features and bug fixes as you won't get update notifications automatically. Any manually installed copies of Penumbra should be removed before switching to the custom plugin respository method, as they will conflict.