Giter Club home page Giter Club logo

ultrakull's Introduction

Discord Version Licence

UltrakULL

UltrakULL (ULTRAKILL Language Library) is a modification (mod) for ULTRAKILL that allows for modification of the game's text strings, effectively allowing for translation and localization into various languages.
This mod's primary purpose is to bridge the gap for localization and translation until ULTRAKILL receives official translations.

Features

  • Translates the entire game from English to any language
  • Support for multiple languages
  • JSON formatting of language files allows for easy-to-understand, simple-to-do modification of strings
  • Change languages directly in-game without having to restart
  • Languages are consistently developed and updated for a faithful localization and translation of the original game text
  • Dubbing support allows for translated spoken dialogue
  • Supports right-to-left languages such as Arabic and Persian
  • Cyrillic character support for languages such as Russian, Ukrainian and Belarusian

Download & Installation

UltrakULL and can be be obtained either through the Releases page (recommended), or via the UltrakULL Discord.

The only prerequisite is a Steam version of ULTRAKILL.
Demo, GOG.com and cracked versions are NOT supported.

Installation via Thunderstore

UltrakULL is available as a ThunderStore mod.

Download and installation can be done automatically via the R2ModManager.

(Downloading the mod via R2ModManager will also automatically download and install the required BepInEx dependencies.)

Installation via GitHub

Installing UltrakULL via GitHub is divided into 2 parts:

  • Installing BepInEx, the modding framework
  • Installing UltrakULL, the mod itself

Installing BepInEx:

  • Download BepInEx 5.4.21 64-bit here.
  • Extract the contents of BepInEx to where your ULTRAKILL install folder is located.
  • Launch ULTRAKILL once so BepInEx can generate the required files and folders in the install folder. Quit the game once it has loaded to the main menu.

Installing UltrakULL:

  • Extract the contents of UltrakULL to your BepInEx folder. Overwrite any files if prompted.

Usage

  • If the mod has loaded correctly, you will see a new "Languages" tab in the Options menu. drawing
  • From the Languages tab, you can browse available translations for the game by selecting the "Browse Languages Online" button. Additionally, language files that are locally installed in the mod folder will be detected and made available for selection any available language based on the language files UltrakULL has found, and will load them into the game.

Troubleshooting

If the mod does not appear to load or work correctly, or errors occur in-game, please open the BepInEx console.

Opening via R2ModManager

Open your mod profile in R2ModManager, and go to Config Editor -> BepInEx.cfg -> Edit Config -> Scroll to "Logging". Set both options to True.

Opening via GitHub

Navigate to BepInEx/config/BepInEx.cfg, and open it in any text editor of your choosing. Scroll down to Logging and set "UnityLogListening" and "LogConsoleToUnityLog" to True.

Restart the game after applying either steps for your use case.

Languages

Languages available & fully compatible with latest game version

Language Contributors Notes
English (U.S) Hakita & The Ultrakill delevopers Grammatical improvements by Clearwater
Belarusian (беларуская) CockenDug
Brazilian Portugese (Português Do Brasil) Veni, 🕯Jackie🕯, MKaid, hebert, FNChannel/FEMChannel, Lizzy ✦, R A Y L A N D E R, DelksBWG
Filipino (Pilipino) MechanicWithAPistol, violence layer when
Russian (русский) Ness, D4N5T3P, lrddd🐢 , Brainy-Stormie, towelie84, Solidus Cumcer, Filin?!
Simplified Chinese (简体中文) Hydracerynitis, ciinore, duke325, ponyweeb, @Skugra, GoGoblin
Spanish (Español) LambCG, Philia, Lukah, Mr. Santiago, Radripizza, BOXBOT!
Thai (ภาษาไทย) Skugra, Winterman
Turkish (Türkçe) Legitname1337, Cester, Legio, Scape, Neige

Languages available but not fully compatible with latest game version

Language Contributors Last update Notes
Czech (Čeština) Mina Act 2
French (Français) Clearwater, Zed, Frizou, osokour, Tamary, Lays, Wish Act 2 French and Quebec variants available
German (Deutsch) Ivory, LiquidEliLest, Psychologemelone44, Termi2, Fabidelune, astr4lis Act 2

Languages in development

Language Contributors Notes
Arabic riko, hamza666, Fancy!Bee, Wish
Bulgarian (Bălgarski) Dan
Croatian (Hrvatski) Rosie
Danish (Dansk) rillebille
Dutch (Nederlands) Foxo, Umbra, Jacket, Luuke
Estonian (Eestikeel) Cremee
Filipino (Pilipino) mxkyle, MecanicWithAPistol, FinnianNeko
Finnish (Suomi) GoreDemon, FracturedStar
Greek (Ελληνικά) Mi pro, thegastank
Hebrew muddy
Hungarian (Magyar) csigachad, Desert
Italian (Italiano) Dav, SimonLuck31, Cammen, ImmortalChanger, The Conselor
Indonesian (Bahasa Indonesia) Arif “Fry” Siregar, mulfok
Japanese (日本語) Liamconn35, kythira
Korean (한국어) ARSE™, Susuchan
Latvian (Latviešu) Eelsoup, сонорный
Portugese (Portugês) Toyota AE86
Polish (Polski) Fikou, Patryk, Spookz, Dualite, Yormit, Abyst, Writenberg, Vee
Slovenian (Slovenščina) chair
Traditional Chinese(繁體中文) GuonuoTW(SmallNo), duke325
Ukrainian (Українська) Rafunny, Blitzo, Keka, ArtSabs, ak11, CsyeCok, twrp, Infernal
Vietnamese (Tiếng Việt) Timmy the ULTRAPlant, Gaius, Jerry, jane

Languages on hold or not actively worked on

Language Contributors Notes
Georgian (ქართული)
Persian (Farsi)
Romanian (Românesc)

Available languages may be directly downloaded for use in-game via the Languages tab in the options menu. This list is updated on a semi-regular basis as new languages are made available. (Last updated on patch 13b, the 10th of December 2023)

Troubleshooting

ULTRAKILL received an update, and UltrakULL is now broken/not working correctly.

As is the case with most updates for other games, any and all updates and hotfixes to ULTRAKILL will almost certainly break mod functionality to some degree. Work to future-proof the mod as much as possible is done to minimise such occurrences, but if an update breaks the mod, it will be fixed as quickly as possible.

My language does not appear as selectable in-game in the language tab.

Language files are formatted in JSON. If it does not appear as available, it is either not formatted correctly or does not match the minimum version required by the mod.
To check if a file is formatted correctly, open JSONLint in your browser, copy and paste the contents of your file into the window and click on "Validate JSON".
If the file is not formatted correctly, JSONLint will report any errors. Errors can be forwarded to the UltrakULL Discord's troubleshooting channel for assistance.

My problem is not listed here.

A dedicated troubleshooting and support channel can be found at the UltrakULL Discord.

FAQ

Can I translate ULTRAKILL into my native language with this mod?

Indeed you can! Thanks to this mod, ULTRAKILL has already been translated into various foreign languages, including French, Brazilian Portugese, Traditional Chinese, with many other languages also in development at the time of release.
If you wish to contribute to, or begin work on a new or existing translation or language, feel free to stop by and inquire at the UltrakULL Discord.

Will this mod affect my saves?

No, this mod merely changes text in the game. It does not alter your saves in any way.

Will this mod prevent Cybergrind highscores?

No, for the same reason as above. It does not alter any gameplay aspects that would give an unfair advantage in any way, and as such, will be safe to set Cybergrind highscores with. If for some reason your Cybergrind highscores are not being submitted, and you are sure they should be doing so, feel free to shoot a message on our Discord and I will take a look at it.

Can voice lines from characters be translated?

As of UltrakULL v1.1.0, dubbing support is available for speaking characters! To learn more about how to add your own lines, check the dubbing documentation.

Where can I follow UltrakULL's development?

I usually like to post updates and news about development in multiple places, including the UltrakULL Discord itself, the New Blood Discord, and my personal Twitter.

Is UltrakULL compatible with other mods?

I cannot guarantee mod compatability with other mods. Mods that do not use the HUD message display functionality should work just fine though.

Documentation

GitHub documentation coming in future. Until then, documentation on how to create your own language can be found in the UltrakULL Discord.

Building

Build instructions coming in future.

Credits & Contributors

UltrakULL created by Clearwater
Additional code contributions by Temperz87 & CoatlessAli
Documentation contributions by Frizou
Language translations by members of the UltrakULL Translation Team (view the Languages section for full information and crediting)
ULTRAKILL created by Arsi 'Hakita' Patala and published by New Blood Interactive

UltrakULL uses the following libraries:

Links

ULTRAKILL Steam page: https://store.steampowered.com/app/1229490/ULTRAKILL/
ULTRAKILL/New Blood Discord: https://discord.gg/newblood
UltrakULL Discord: https://discord.gg/ZB7jk6Djv5

ultrakull's People

Contributors

clearwateruk avatar jelana avatar frizouwasthere avatar temperz87 avatar coatlessali avatar hydraxous avatar flazhik avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.