Store Page
A Hat in Time
All Discussions Screenshots Artwork Broadcasts Videos Workshop News Guides Reviews

A Hat in Time

Store Page
A Hat in Time > Guides > Don's Guides
Not enough ratings
Fixes & Troubleshooting Tips (Ver 1.1)
By Don
Tips for fixing and troubleshooting problems with A Hat in Time and modding related issues
   
Award
Favorite
Favorited
Unfavorite
Created by
Don
Offline
Category: Modding or Configuration, Workshop
Languages: English
Posted
Updated
25 Jun, 2023 @ 7:21am
1 Jul @ 1:12am
371 Unique Visitors
19 Current Favorites
Guide Index
Overview
◼ COMMON SOLUTIONS 
⠀▸ HOW DO I VERIFY FILES? 
⠀▸ MODS MISSING 
⠀▸ MOD ITEMS MISSING 
⠀▸ MOD NEEDS TO BE RECOOKED BY THE AUTHOR 
⠀▸ RAN OUT OF VIDEO MEMORY 
⠀▸ ACHIEVEMENT COMMUNITY THANKS YOU 
⠀▸ CAN'T SMUG DANCE 
⠀▸ CAN'T USE EMOTES 
⠀▸ GAME EVENT 
⠀▸ LIMIT EDITOR POWER / GPU USAGE 
▶ LAUNCH OPTIONS 
▶ LINUX / STEAM DECK 
⠀ 
▶ VANESSA'S CURSE 
⠀▸ VANCURSE: PROGRESS LOST 
⠀▸ VANCURSE: PLEASE DISABLE / UNEQUIP MOD 
⠀▸ VANCURSE: LOADING ASSETS TAKES LONG 
⠀▸ VANCURSE: SCRIPTS 
⠀ 
▶ SAVE FILE 
⠀▸ SAVE FILE ISSUES 
⠀▸ RECOVER SAVE FILE 
⠀ 
▶ EDITOR 
⠀▸ RECOVER / AUTOSAVE 
⠀▸ RESET EDITOR 
⠀▸ LOAD ERRORS 
⠀▸ ASSET DATABASE CHECKPOINT 
⠀▸ TEMPLATE MAPS MISSING OR CRASHING 
⠀▸ PLAYER WITH NO BODY 
⠀▸ AUDIO 
⠀▸ COMPILING MATS EVERY LAUNCH 
▶▶ LAYOUT / VIEW 
⠀⠀▸ EDITOR VIEW / LAYOUT MESSED UP 
⠀⠀▸ TEXT SCALING / CUT OFF 
⠀⠀▸ STEAM OVERLAY ISSUES 
▶▶ CRASHING / NOT LAUNCHING 
⠀⠀▸ PLAY IN EDITOR (PIE) CRASH 
⠀⠀▸ WINTAB32.DLL 
⠀▸ EDITOR ON LINUX 
⠀ 
▶ ASSETS / CONTENT BROWSER 
⠀▸ FAILED TO SAVE PACKAGE 
⠀▸ FAILED TO IMPORT ASSET 
⠀▸ ASSET NOT WORKING 
⠀▸ CONTENT PACKAGE NOT SHOWING 
⠀▸ MY ASSETS IN "HatinTime.." PACKAGE DON'T EXIST ANYMORE 
⠀▸ RE-IMPORTING ASSET DOESN'T WORK 
⠀▸ AMBIGUOUS PACKAGE NAME 
⠀▸ SOUNDWAVE 44100Hz 16 BITS 
▶▶ TEXTURE 
⠀⠀▸ ONLY PNG FILES WITH RGB COLOR AND RGBA COLOR MODES 
⠀⠀▸ NOT POWER OF 2 
⠀⠀▸ FAILED TO IMPORT TEXTURE2D! 
⠀⠀▸ LOW RESOLUTION 
▶▶ MATERIAL 
⠀⠀▸ DOF 
▶▶ STATIC & SKELETAL MESHES 
⠀⠀▸ SKELETAL MESH 
⠀⠀▸ MORPH TARGETS / SHAPE KEYS 
⠀⠀▸ PHYSICS ASSET 
⠀ 
▶ SCRIPTING / CODING 
⠀▸ HOW DO I SEE FILE EXTENSIONS? 
⠀▸ SYNTAX HIGHLIGHTING 
⠀▸ COMPILER CRASH 
⠀▸ COMPILE WARNING'S 
⠀▸ COMPILE ERROR'S 
▶ COOKING ERROR'S 
⠀ 
▶ MOD MANAGER 
⠀▸ MOD MANAGER NOT LAUNCHING 
⠀▸ UNABLE TO SET MOD ICON 
⠀▸ SUBMITTING UPDATE TO STEAM WORKSHOP DOESN'T WORK 
⠀▸ UNABLE TO UPLOAD 
⠀▸ MODINFO.INI RESETTING 
⠀▸ ERROR IN CONTENT 
⠀▸ ISSUES AFTER / DURING COOKING 
⠀ 
⠀▸ UE VIEWER / UMODEL 
⠀ 
▶ I STILL NEED HELP 
⠀▸ MORE TIPS 
◼ STEAM RULES AND TERMS OF SERVICE 
FEEL FREE TO SUBMIT OTHER TIPS & INFO! 
Comments
◼ COMMON SOLUTIONS
⠀
  • Verify integrity of files both Game and Editor via Steam
    Library > Right-click game or tools > Properties > Installed Files > Verify integrity of game files

  • Restart your system.
    Not necessarely just Shut Down, but actually Restart.

  • Make sure your file paths, file names, assets names, etc. do not use any special characters like
    !, -, ?, ö. á, space (use underscore _ instead), etc.

  • Try taking a look at the Launch.log (or Launch2.log) file in
    \HatinTime \HatinTimeGame \Logs | Launch2.log

  • Re-Install Editor and maybe even the Game, remember to backup your Mods and
    Save Data!

  • Move or uninstall all installed mods.
    Can try adding one by one after to find the mod causing issues.

  • Update Proton to the latest version, maybe even the experimental one.
    ⠀
⠀
⠀
⠀
⠀▸ HOW DO I VERIFY FILES?
⠀
⠀
⠀
⠀▸ MODS MISSING
  • Can be caused by having Mods Disabled in the settings menu.
    (may require restarting game)
    ⠀
    ⠀
  • Try subscribing to the mod(s) on the workshop outside of the game.
    Have the game closed when subscribing.

  • Mac version of the game does not support mods.
    ⠀
  • Some older versions of the game via Beta's don't support mods.

  • Pirated versions of the game don't support mods.

  • LINUX / STEAM DECK:
    Update Proton to the latest version, maybe even to the experimental one.
    • ⠀
⠀
⠀
⠀
⠀▸ MOD ITEMS MISSING
⠀
⠀
⠀
⠀▸ MOD NEEDS TO BE RECOOKED BY THE AUTHOR
  • This can happen when installing mods in-game / while playing the game and subscribing to mods.
    Safest to download mods while game is closed.

  • Some mods are really old and have not been updated, you can try playing the mod via an older version of the game. Older versions can be accesed via
    Library > Game Properties > Betas
    ⠀⠀Will affect your save file so back it up!

  • If issues persists then Author of the mod needs to
    re-compile and re-cook the mod.
    ⠀
⠀
⠀
⠀
⠀▸ RAN OUT OF VIDEO MEMORY

⠀⠀⠀⠀
  • You can try increasing the Page file / Virtual memory size on Windows
    1. In Taskbar search for "Advanced System Settings" and open it. Or click start and search for "Run" and open, then type in "sysdm.cpl". 2. In System Properties go to Advanced > under Performance > Settings.. and in Performance Options go to Advanced > under Virtual memory > Change.. 3. If necessary, uncheck "Automatically manage page file size for all drives". 4. Select your System drive in the drive list. 5. Select Custom size. 6. Change the "Initial size" and "Maximum size" to higher values. 16 GB (16000 MB) for example if you have 8 GB of RAM. 7. Click Set. 8. Click OK / Apply.

  • Uninstall / un-subscribe mods.

    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀▸ ACHIEVEMENT COMMUNITY THANKS YOU
  • The achievement only counts Rift Tokens received from Mod Time Pieces,
    NOT regular Rift Tokens found in levels.
    ⠀
⠀
⠀
⠀
⠀▸ CAN'T SMUG DANCE
  • To be able to do the Smug Dance you need to own a copy of Seal the Deal
    https://steamhost.cn/app/787340/A_Hat_in_Time__Seal_the_Deal/
  • To perform the dance you need to press in order
    On Keyboard:
    1, 4, 1, 4⠀⠀or⠀⠀4, 1, 4, 1
    On Controller DPAD:
    UP, DOWN, UP, DOWN⠀⠀or⠀⠀DOWN, UP, DOWN, UP
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀▸ CAN'T USE EMOTES
⠀
⠀
⠀
⠀▸ GAME EVENT
⠀
GAME EVENT MISSING
  • Game Event missing in-game can be caused by not having it enabled in settings.
    (may require restarting game)
    ⠀
    ⠀
  • Event missing can be caused by playing on a different version of the game like via Beta's under game Properties.

  • Non-Steam versions of the game don't support Live Game Events.
    ⠀
⠀
⠀
MISSING MODS FROM EVENT
  • Mods downloaded via the Death Wish map for example aren't permament installations.
    To keep them installed you will need to subscribe to the mod on the Steam Workshop.
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀▸ LIMIT EDITOR POWER / GPU USAGE
⠀
You can limit the editors power usage / gpu usage via your graphics card control panel.
Useful when using the editor on a laptop to prevent fans from spinning up.
⠀
Nvidia
    ⠀⠀
  • If the editor is not in the program list you can add it manually from the files
    \HatinTime \Binaries \Win64 - HatinTimeEditor.exe
    ⠀
⠀
⠀
⠀
▶ LAUNCH OPTIONS
⠀
    -nointro | -novid Skips UDK & GFB logos.
    -noverify Stops the game from verifying, useful if game crashing often due to mod, or if the game is verifying often on Steam Deck.
    -nomods Stops game from loading any and all mods.
    -IGNOREFATALD3D9 The flag ignores what would otherwise be a fatal response from your DirectX driver. Mostly useful if using Vulkan / DXVK.
    -NoShaderCompile Prevents shaders from compiling.
    ⠀
    No idea if these actually work with AHIT
    -HIGH Gives the game app top priority.
    -USEALLAVAILABLECORES Tell the game to use all cores on a multi core CPU.
    -THREADS 4 Number of CPU threads. Can be used with -USEALLAVAILABLECORES, value of 4 as an example.
    -nopreload Skips loading models until needed.
    ⠀
    DEBUG
    -utrace Prints all functions calls to .log file.
    -utracecrash Prints some functions calls to .log file on game crash.
    -PrintShaders Prints to .log file, no further documentation..
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
▶ LINUX / STEAM DECK
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀⠀⠀▪⠀⠀▪⠀⠀◼⠀⠀◼⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀◼⠀⠀◼⠀⠀▪⠀⠀▪
▶ VANESSA'S CURSE
⠀▸ VANCURSE: PROGRESS LOST
  • Due to the editor not having the script files it will reset all Vanessa's Curse progress on the save file you used in-editor.

    You can try recovering your progress with a automatic backup save file.
    \HatinTime \HatinTimeGame \SaveData
    ⠀
    ⠀
    To avoid losing your progress you can either select a different save file manually in
    A Hat in Time > Save Slot > Slot
    ⠀
    Or make save slot 2 your main one and use slot 1 for modding.
    (Basically just change slot 1 and 2 names in the save file folder or
    create a copy of slot 1 and rename it to slot 2)
    ⠀
⠀
⠀
⠀
⠀
⠀▸ VANCURSE: PLEASE DISABLE / UNEQUIP MOD
    ⠀
  • Some mods are not allowed in Vanessa's Curse, un-equip the mod item or uninstall it.

  • Alternatively disable all mods in the settings menu. (may require restarting game)
    ⠀
⠀
⠀
⠀
⠀▸ VANCURSE: LOADING ASSETS TAKES LONG
⠀
⠀
⠀
⠀▸ VANCURSE: SCRIPTS
  • Currently Vanessa's Curse script files are shipped with the game files.
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀⠀⠀▪⠀⠀▪⠀⠀◼⠀⠀◼⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀◼⠀⠀◼⠀⠀▪⠀⠀▪
▶ SAVE FILE
⠀▸ SAVE FILE ISSUES
  • Save files from before major DLC release like Nyakuza or even further back like since the game's release or during Modding Beta likely don't work properly in the latest version of the game, with messed up inventories for example.

  • You can download different Save Files in the A Hat in Time Speedrun section.
    https://www.speedrun.com/ahit/resources
    ⠀
⠀
⠀
⠀
⠀▸ RECOVER SAVE FILE
  • You can try recovering your progress with a automatic backup save file.
    \HatinTime \HatinTimeGame \SaveData
    ⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀⠀⠀▪⠀⠀▪⠀⠀◼⠀⠀◼⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀◼⠀⠀◼⠀⠀▪⠀⠀▪
▶ EDITOR
⠀▸ RECOVER / AUTOSAVE
  • Map (.umap) and Content (.upk) files can be recovered in
    \HatinTime \HatinTimeGame \Autosaves \HatinTime \HatinTimeGame \Autosaves \Backup
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀▸ RESET EDITOR
  • If it is just the view you can try resetting it all in
    Modes (arrow next to it) > Show > Reset to Default
    ⠀
    ⠀
  • For a hard reset you can delete the Config files in
    \HatinTime \HatinTimeGame \Config
    ⠀⠀and then restore them by Verifying Files.
    ⠀
⠀
⠀
⠀
⠀▸ LOAD ERRORS
    ⠀⠀
  • You can safely ignore this message window on editor boot up if the message isn't referring to your own files or assets.
    ⠀
⠀
⠀
⠀
⠀▸ ASSET DATABASE CHECKPOINT
    ⠀
  • Generally you can ignore this message and click "Wait a Week"
    ⠀
  • Doing "Check Now" once can have some benefit to loading up assets for example Vanessa's Curse assets.
    ⠀
⠀
⠀
⠀
⠀▸ TEMPLATE MAPS MISSING OR CRASHING
    ⠀
  • Launch the editor, then close it without crashing it.
    Editor likely didn't complete first time setup.
    ⠀
⠀
⠀
⠀
⠀▸ PLAYER WITH NO BODY
    ⠀
  • This can be caused by not having a save file

  • KillZ Volume causes this, use Jumpfail Recovery Volume instead.
    ⠀
⠀
⠀
⠀
⠀▸ AUDIO
⠀
NO AUDIO OR TOO LOUD
  • Editor uses the same audio settings as the game, go to in-game settings and adjust sound volume there.
    You can save the settings in PIE by closing the game via Pause Menu (P) instead of force closing with Esc.

  • Re-open the editor.
    Editor can loose the audio device if it changes, for example disconnecting your headphones and re-connecting them back.
    ⠀
⠀
AUDIO CRACKLE WITH EVERY ACTION
  • Restart your computer.
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀▸ COMPILING MATS EVERY LAUNCH
⠀
  • Try letting the editor do a full shader compile and then close it without crashing it.
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
▶▶ LAYOUT / VIEW
⠀⠀▸ EDITOR VIEW / LAYOUT MESSED UP
  • Can be caused by Vulkan / DXVK, remove it.

  • For more options refer to RESET EDITOR section.
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀

WINDOW HIDDEN / FAILS TO APPEAR
  • Right-click Windows Taskbar and select "Cascade Windows"
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀⠀▸ TEXT SCALING / CUT OFF
  • Generally caused by Windows layout scaling.
    Settings > Display: Scale and layout
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀⠀▸ STEAM OVERLAY ISSUES
  • Disable Steam Overlay for the Modding Tools in Properties.
⠀
⠀
  • Try minimizing the editor windown and opening it again.

  • If you're using open mod manager try adding it to the Steam library via
    "Add a Non-Steam Game..." and disable Steam Overlay for that as well.
    ⠀
⠀
⠀
⠀
▶▶ CRASHING / NOT LAUNCHING
  • Try opening the Editor directly from the files, this can give a proper error code.
    \HatinTime \Binaries \Win64
    ⠀
    ⠀
  • Try taking a look at the Launch.log file.
    \HatinTime \HatinTimeGame \Logs
    ⠀
    ⠀
  • Disable Steam Overlay for the Modding Tools in Properties.
    ⠀
    ⠀
  • Switch back from Experimental Beta
    ⠀
  • Don't use Vulkan / DXVK to run the editor. Make sure to use DirectX (DX9 for AHIT)

  • Don't remove files before or while editor is launching.

  • Verify Files.

  • Move or uninstall all installed mods.
    Can try adding one by one after to find the mod causing issues.

  • Corrupted SteamWorkshop.ini file can cause the editor not launch, file can be found in
    \HatinTime \HatinTimeGame \Mods

  • Ensure that the Game and Editor is installed in the same file path.

  • If you have a drawing tablet see "WINTAB32.DLL" section.

    MSVCR100.DLL
  • Commonly related to Microsoft Visual C++ Redistributable 2010 dll
    Download the 64-bit (x64) and install it.
    https://www.microsoft.com/en-us/download/details.aspx?id=26999&OCID=AID2000142_aff_7794_312327
    ⠀


  • Make sure none of your files and assets share the same name for example the mods Folder Name and Content (.upk) or Map (.umap)

    DON'T DO THIS
    \HatinTime \HatinTimeGame \Mods \MY_MOD \HatinTime \HatinTimeGame \Mods \MY_MOD \Content \MY_MOD.upk \HatinTime \HatinTimeGame \Mods \MY_MOD \Maps \MY_MOD.umap

    DO THIS
    \HatinTime \HatinTimeGame \Mods \MY_MOD \HatinTime \HatinTimeGame \Mods \MY_MOD \Content \MY_MOD_Content.upk \HatinTime \HatinTimeGame \Mods \MY_MOD \Maps \MY_MOD_Map.umap
    ⠀
⠀
ABSOLUTE PARENT

    ⠀
  • Delete files in
    \HatinTime \HatinTimeGame \Mods \MY_MOD \CompiledScripts\ \HatinTime \HatinTimeGame \Mods \MY_MOD \CookedPC\ \HatinTime \HatinTimeGame \Mods \MY_MOD \Shadercache\
    Then try launching the editor and see if you can access your Content Package (.upk).

    Once you have loaded your content package fix any broken Material Instances by assigning it the Parent Material.

    ⠀
⠀
⠀
⠀
⠀⠀▸ PLAY IN EDITOR (PIE) CRASH
  • Verify Files and then launch the editor, after done launching close editor without crashing it.
    Can tell by whether if the template maps are available when creating a new map.

  • Could be caused by a bad actor in the level or something the player is wearing,
    try removing it.

  • Streamed in maps can cause issues.

  • Disable Game Recording for the Modding Tools in Steam Library
    Right Click "AHIT - Modding Tools" > Properties > Game Recording > Set to Disabled.

  • If you have a drawing tablet see "WINTAB32.DLL" section.
    ⠀
⠀
⠀
⠀
⠀⠀▸ WINTAB32.DLL
    ⠀
  • Modern drawing tablet drivers can cause issues with the editor.

    Best solution is to keep two different copies of wintab32.dll
    - one without the drawing tablet drivers installed - and one with the tablet drivers installed

    You can then copy paste one or the other into the System32 folder when you need to.
    C: \Windows \System32

    Credit to Henning Sanden @henningsanden on twitter for the solution, used for when working with more than one drawing tablet driver.
    https://twitter.com/henningsanden/status/1363797658478010368


    Alternative is to keep the drawing tablet drivers uninstalled while using the editor.
    ⠀
⠀
⠀
⠀
⠀▸ EDITOR ON LINUX
  • You can try following this guide by m_cube on github
    https://gist.github.com/mcu8/dc62137ceaa4ccf1c37772caec028866
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀⠀⠀▪⠀⠀▪⠀⠀◼⠀⠀◼⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀◼⠀⠀◼⠀⠀▪⠀⠀▪
▶ ASSETS / CONTENT BROWSER
⠀▸ FAILED TO SAVE PACKAGE
  • Make sure you don’t have two instances of the editor running.
⠀
⠀
⠀
⠀
⠀▸ FAILED TO IMPORT ASSET
  • Files imported from a file path with special characters doesn't work.
    For example characters like
    ä, é, å, ?, etc..
    for example file path like this won't work
    C:\Users\NÄMÉ\Desktop
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀▸ ASSET NOT WORKING
  • Make sure you didn't save or create the assets inside the "Shadercache" section.

  • Some assets need certain properties to be enabled, look at another asset for reference.
    For example Materials need "Used With Skeletal Meshes" to be enabled when used with Skeletal Meshes.
    ⠀
⠀
⠀
⠀
⠀▸ CONTENT PACKAGE NOT SHOWING
  • Editor doesn't automatically load content packages if they exist in an unfamiliar location.

    Make sure to place your .upk content package in the "Content" folder for your mod. For example
    \HatinTime \HatinTimeGame \Mods \YOUR_MOD_FOLDER \Content
    if the folder does not exist you can create it yourself.
    ⠀
    ⠀
  • You can manually locate the .upk content package in the Content Browser.
⠀
⠀
⠀
⠀
⠀▸ MY ASSETS IN "HatinTime.." PACKAGE DON'T EXIST ANYMORE
  • Don’t create assets in cooked game packages, create your own package and save that.

    You can do this by importing a new asset and when doing that give the package a unique name.
    ⠀
⠀
⠀
⠀
⠀▸ RE-IMPORTING ASSET DOESN'T WORK
  • There's likely an issue with the asset you are trying to re-import.

    Editor doesn't generally say anything if something is wrong with the asset when
    re-importing so importing it as a new asset can help bring up a proper error message.
    ⠀
⠀
⠀
⠀
⠀▸ AMBIGUOUS PACKAGE NAME
  • This generally doesn't cause issues but to be clear.
    Two of the same file name exists in your files.

    For example a copy of the workshop version and editor version.
    Or two mods with the same file names in them like
    “MyPackage.upk”. To fix uninstall one of the mods.
    ⠀
    ⠀
  • Unsubscribe from your own mod release. (Still have the editor copy)
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀▸ SOUNDWAVE 44100Hz 16 BITS
    ⠀
  • The Hat Editor can only import .wav / .WAV files that are 44100Hz and 16bits.
    To convert a sound file you can use a free program like Audacity.

    If you are worried about latest versions collecting telemetry data you can download one of the older versions starting from 3.0.2
    https://www.fosshub.com/Audacity-old.html

    Bottom left option in Audacity.

    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
▶▶ TEXTURE
⠀⠀▸ ONLY PNG FILES WITH RGB COLOR AND RGBA COLOR MODES
    ⠀
  • Make sure your image is in supported color mode - RGB or RGBA
    ⠀
    Photoshop : Image > Mode > RGB Color



  • Try saving your file as .TGA (Targa)

  • If your image doesn't have any opacity you can re-save the image via MS Paint,
    this will convert it to RGB Color.
    ⠀
⠀
⠀
⠀
⠀⠀▸ NOT POWER OF 2
⠀
⠀⠀This message also acts as a general error message when something else goes wrong with the import.
    ⠀⠀
  • Images not power of 2 won't get optimized properly,
    which un-adressed can cause performance issues.

    Make sure your image is a power of 2 size on Height and Width.
    For example:
    2x2, 4x4, 8x8, 16x16, 32x32, 64x64, 128x128, 256x256, 512x512, 1024x1024, 2048x2048
    ⠀

    Image source: Display Daily [displaydaily.com]
    ⠀
    ⠀
    The lack of Mip Mapping also causes visual issues.
Image source: Wikipedia [en.wikipedia.org]
⠀
⠀
⠀
⠀
⠀⠀▸ FAILED TO IMPORT TEXTURE2D!
  • Save your image as .png

  • Try saving your file as .TGA (Targa)

  • Make sure your image is a power of 2 size on Height and Width.
    For example:
    2x2, 4x4, 8x8, 16x16, 32x32, 64x64, 128x128, 256x256, 512x512, 1024x1024, 2048x2048

  • Make sure your image is in supported color mode - RGB or RGBA

  • Make sure your image is in supported bit depth, 24-bit or 32-bit

  • If your image doesn't have any opacity you can re-save the image via MS Paint,
    this will convert it to RGB Color.

  • Don't try importing .DDS files.
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀⠀▸ LOW RESOLUTION
  • Your game settings can affect the import resolution for example custom Config files,
    odd I know..
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
▶▶ MATERIAL
⠀⠀▸ DOF
⠀
BLURRY AGAINST SKY
  • Turn on "Use Lit Translucency Post Render Depth Pass" in the material properties.
    Will not work if "Lighting Model" is "Unlit"
    and will not work on Sprite Components
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
▶▶ STATIC & SKELETAL MESHES
⠀⠀▸ SKELETAL MESH
⠀
UE4 notes may help but keep in mind some limitations are way smaller in UE3 / UDK.
https://docs.unrealengine.com/4.26/en-US/WorkingWithContent/Importing/FBX/FbxErrors/

FBX CONTAINS A SKELMESH THAT IS NOT A CHILD NODE
  • Make sure that the skeletal mesh doesn't have more than 256 bones after exporting to FBX.
    You should only be exporting deformation bones, you can enable this during export in Blender by enabling "Only Deform Bones" during exporting.
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
HAS NO VERTEX INFLUENCE
  • Either your model doesn't have any weights painted on it for the Armature / Skeleton
    or has some vertices on the model that don't have any weights painted on them.

    To fix, weight paint the model or the vertices missing weights.
    ⠀


SKELMESH WITH ANIMS COLLAPSING OR STRETCHING OUT
  • The Model Scale and Animation Scale, the scale at which animations are made are two different things.
    You need to animate your model at the correct scale.
    Generally need to scale the model and rig by about 10x (so from 1.0 to 10.0) if the model is collapsing in on itself. Down scale if it's stretching out.

    Blender Scene Scale and Export Scale options are rather deceptive in this case because they only affect model scale, not animation scale.
    ⠀
⠀
⠀
⠀
⠀⠀▸ MORPH TARGETS / SHAPE KEYS
⠀
CRASHING ON IMPORT
  • Sometimes when importing the Morph Targets with the Skeletal Mesh, the editor will crash.
    The error message may say something about a Pure virtual function being called and then crashes.

    Either way if the editor crashes when importing a Skeletal Mesh and you have Morph Targets, toggle importing Morph Targets OFF and do the following to import Morph Targets manually.

    1. When importing the Skeletal Mesh toggle "Import Morph Targets" OFF.
    2. Once you have your Skeletal Mesh imported open it in the AnimSet Editor.
    3. In AnimSet Editor go to "File" > and click "NewMorphTargetSet..." and create it.
    4. Open your new Morph Target Set asset in the Content Browser or make sure it is set as the active one in the Morph section with your Skeletal Mesh.
    5. In AnimSet Editor go to "File" > and click "Import MorphTarget..."
    6. Click Yes on all message popups. Depending on how many Morph Targets you have this can take a moment.
    ⠀
⠀
⠀
⠀
⠀⠀▸ PHYSICS ASSET
⠀
PHYSICS ASSET NOT WORKING
  • Low graphics settings will disable physics assets.

  • Actors with Physics set to "PHYS_None" will prevent Physics Asset from working.

  • You may need to set Physics Asset True and maybe use InitMaterialInstancesMesh function to trigger the physics asset to work.
    Hat_Player(Player).Mesh.SetPhysicsAsset(PhysicsAsset, true); Hat_Player(Player).Mesh.SetHasPhysicsAssetInstance(True); // Magic Bullet for triggering Physics Asset class'Hat_NPC'.static.InitMaterialInstancesMesh(Hat_Player(Player).Mesh);
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀⠀⠀▪⠀⠀▪⠀⠀◼⠀⠀◼⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀◼⠀⠀◼⠀⠀▪⠀⠀▪
▶ SCRIPTING / CODING
⠀▸ HOW DO I SEE FILE EXTENSIONS?
  • In Windows File Explorer go to
    View > Options > Change folder and search options > View > Advanced settings > Uncheck "Hide extensions for known file types

For Windows 11 can follow the process here.
https://www.elevenforum.com/t/show-or-hide-file-name-extensions-for-known-file-types-in-windows-11.898/
⠀
⠀
⠀
⠀
⠀▸ SYNTAX HIGHLIGHTING
⠀
VISUAL STUDIO CODE / VSCODIUM

⠀
⠀
NOTEPAD++
  • You can download a UnrealScript syntax highlighter here.
    https://romerounrealscript.blogspot.com/2011/10/setting-up-notepad-for-unrealscript.html
    ⠀
    Once you have downloaded the .xml file you can add it in Notepad++ by going to
    Language > User Defined Language > Define your language
    ⠀
    then simply click Import.
    ⠀
    After all that you can now select UnrealScript as a language.

    If you're using a different background color you may need to correct the text background color
    Settings > Style Configurator > Enable global background color
    ⠀
⠀
⠀
⠀
⠀▸ COMPILER CRASH
⠀
  • Commonly happens when there's something wrong with a for loop in your code.
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀▸ COMPILE WARNING'S
⠀
Warning, Can't find Asset'something'. Does it exist?
  • Make sure your .upk package is in the "Content" folder.
    \HatinTime \HatinTimeGame \Mods \YOUR_MOD \Content
  • Make sure you have saved your .upk package after making changes to it,
    File > Save Modified for example.

  • Make sure the package it's referencing actually exists within the "Mods" folder, for example if you used assets from another mod.
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀▸ COMPILE ERROR'S
⠀
Error, Script vs class name mismatch.
  • Both the FILE NAME and CLASS NAME have to be the same.
    For example if the FILE NAME is
    udk_gamemod_mod.uc
    then the CLASS NAME would be for example.
    udk_gamemod_mod extends ...
  • Make sure to save your .uc file after changes!
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀

STRUCT not working
  • Struct variable needs to be defined AFTER the struct, for example.
    struct sVar { Something... } var sVar YourStructVar
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
▶ COOKING ERROR'S
⠀
EXIT CODE: 3
  • Map files can become corrupted from copy pasting enemy actors, to fix you will need to replace all enemy actors in the level.
    Can try using a Autosave file to recover some lost work.
    \HatinTime \HatinTimeGame \Autosaves
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀

COOKING CRASHES
  • If your map files are too big in file size they may crash the cooking process.
    See if cooking works without the map file(s), and either split or use level streaming to lower the file size of individual map file(s).
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀⠀⠀▪⠀⠀▪⠀⠀◼⠀⠀◼⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀◼⠀⠀◼⠀⠀▪⠀⠀▪
▶ MOD MANAGER
⠀▸ MOD MANAGER NOT LAUNCHING
  • Verify integrity of files both Game and Editor vis Steam
    Library > Righ-click game or tools > Properties > Installed Files > Verify integrity of game files

  • Restart your system.
    Not necessarely just Shut Down, but actually Restart.

  • Re-Install Editor and maybe even the Game, remember to backup your Mods and Save files!

  • Move or uninstall all installed mods.
    Can try adding one by one after to find the mod causing issues.

  • Corrupted SteamWorkshop.ini file can cause the Mod Manager to not launch,
    file can be found in
    \HatinTime \HatinTimeGame \Mods | SteamWorkshop.ini

  • Ensure that the Game and Editor is installed in the same file path.
    ⠀
⠀
⠀
⠀
⠀▸ UNABLE TO SET MOD ICON
  • Mod icons need to be in supported file format ( .jpg .png .gif )
    note: .gif and animated png files only work on the workshop page.

  • Mod icons need to be square in size like 512x512 for example.

  • Mod icons need to be below 1MB in size.
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀▸ SUBMITTING UPDATE TO STEAM WORKSHOP DOESN'T WORK
  • Make sure you are not using any special characters in the update log like
    !, -, ?, ö. á, space (use underscore _ instead), etc.
    Best to just type “update” in to the update log and then change the log on the Steam Workshop page afterwards.


  • You can't upload or update mods on an account that doesn't own a copy of the game.

  • Steam workshop may be under maintenance.
    ⠀
⠀
⠀
⠀
⠀▸ UNABLE TO UPLOAD
  • Usually happens if the first upload fails.
    Remove the mod entry from "SteamWorkshop.ini" file in
    \HatinTime \HatinTimeGame \Mods | SteamWorkshop.ini

  • You can't upload or update mods on an account that doesn't own a copy of the game.

  • Steam workshop may be under maintenance.
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀▸ MODINFO.INI RESETTING
  • Mod Manager did not have the latest copy loaded. To do that click the "Refresh" button after saving your changes.

    Alternatively edit the file while the Mod Manager is closed.
    ⠀
⠀
⠀
⠀
⠀▸ ERROR IN CONTENT
    ⠀
  • Happens when the Mod Manager doesn't recognize the file format.
    For example Localization files that aren't ".int", you can remove these from the folder until done compiling and cooking. Then put them back.
    ⠀
⠀
⠀
⠀
⠀▸ ISSUES AFTER / DURING COOKING
⠀
ACTORS MISSING OR NOT FUNCTIONING
  • Don't use classes from workshop mods, use your own copy or the base game's instead.

  • Alwaysloaded issues can cause things to not work properly.
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
ALWAYSLOADED
    ⠀
  • You can only extent alwaysloaded classes.
    To get around the issue you can try creating your own classes and extend those.

  • Alternatively can try a more advanced method.
    • https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=2888211200⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀

4GB SIZE LIMIT ON COOKED ASSETS
    ⠀
  • Issue is assets cooked to alwaysloaded exceeding the 4gb limit. All mods are cooked as alwaysloaded by default.

    Originally posted by MekuCube:
    To get around this, you want to avoid hard referencing classes with assets in them (models, sounds, etc). This is usually done by having a ‘base’ class with just code and no assets, which is referenced instead. Then your class with assets is made a subclass of the base class
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀⠀⠀▪⠀⠀▪⠀⠀◼⠀⠀◼⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀◼⠀⠀◼⠀⠀▪⠀⠀▪
⠀▸ UE VIEWER / UMODEL
Official website: https://www.gildor.org/en/projects/umodel
⠀
CRASHING WHEN TRYING TO EXPORT
  • UE Viewer is not able to export certain assets from the game due to incompatability reasons.
    These assets can generally be exported via the Editor directly instead.
    Note: Simplified Editor generally needs to be turned off for this.

    Best to simply have Textures & Sound checked only for UE Viewer.
    ⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀
⠀⠀⠀▪⠀⠀▪⠀⠀◼⠀⠀◼⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀⏹⠀⠀◼⠀⠀◼⠀⠀▪⠀⠀▪
▶ I STILL NEED HELP
⠀
  • Try askin for help in the official A Hat in Time Discord #modding-help channel,
    you can also try searching for answers there.
    ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀
⠀
⠀
⠀
⠀▸ MORE TIPS
⠀
Pressed the wrong button or looking for all the editor shortcuts?
https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=2422750051

Looking for fonts used in the game?
https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=3291299717
⠀
⠀
⠀
◼ STEAM RULES AND TERMS OF SERVICE
⠀
⠀
⠀
FEEL FREE TO SUBMIT OTHER TIPS & INFO!
5 Comments
< >
Don  [author] 23 Jul, 2023 @ 1:32pm 
Added both, thanks!
UnDrew 23 Jul, 2023 @ 9:04am 
Oh, and I suppose the guide could also mention how both the game and editor should share the same install path? I'm not sure if steam is capable of enforcing that, but it probably wouldn't hurt to mention it here.
UnDrew 23 Jul, 2023 @ 7:16am 
Apparently if SteamWorkshop.ini gets corrupted for some reason, it'll prevent the modding tools from launching (someone found this out by chance yesterday in #modding-help).
Don  [author] 25 Jun, 2023 @ 7:36am 
Added a small note of its own for that, thanks!
UnDrew 25 Jun, 2023 @ 7:32am 
I think in Ambiguous Package Name, it could also state that subscribing to your own mod (which isn't necessary at all) can cause that warning to pop up.