Half Sword Trainer Mod for Half Sword demo v0.3 gives you Invulnerability, Super Strength, configurable level of enemy NPCs, jumping, shooting, and the ability to spawn armour, weapons, NPCs and objects (and despawn them if you made a mistake), setting game speed and more. The mod also has a detailed HUD with player stats.
Permissions and credits
Credits and distribution permission
Other user's assetsAll the assets in this file belong to the author, or are from free-to-use modder's resources
Upload permissionYou are not allowed to upload this file to other sites under any circumstances
Modification permissionYou must get permission from me before you are allowed to modify my files to improve it
Conversion permissionYou can convert this file to work with other games as long as you credit me as the creator of the file
Asset use permissionYou must get permission from me before you are allowed to use any of the assets in this file
Asset use permission in mods/files that are being soldYou are not allowed to use assets from this file in any mods/files that are being sold, for money, on Steam Workshop or other platforms
Asset use permission in mods/files that earn donation pointsYou are not allowed to earn Donation Points for your mods if they use my assets
Author notes
This author has not provided any additional notes regarding file permissions
File credits
This author has not credited anyone else in this file
Donation Points system
This mod is not opted-in to receive Donation Points
Changelogs
Version 0.8
Adding Resurrection and death screen bypass, and fixing some issues. Killing NPCs now explodes their heads and guts. Despawning NPCs is a separate functionality.
Version 0.7
Adding the ability to jump, scale spawned weapons and shoot projectiles. Minor UI changes. UE4SS 3.x compatibility.
Version 0.6
Game speed change (Slow motion or faster) and freezing/unfreezing NPCs works now. Crashes still happen.
Version 0.5
Killing all NPCs works. Spawning a Boss fence works. Various minor fixes. Bad items commented out so you can't spawn them by accident
A trainer mod for Half Sword demo v0.3 (Steam release). It gives you Invulnerability, Super Strength, configurable level of enemy NPCs, jumping, shooting, and the ability to spawn armour, weapons, NPCs and objects (and despawn them if you made a mistake), setting game speed and more. The mod also has a detailed HUD with player stats. USE AT YOUR OWN RISK. Compatibility with newer demo versions not guaranteed, and the older demo from itch.io won't work. The mod requires UE4SS (version 2.5.2 or 3.x.x as of now) to work. The mod is written in Lua, so you can understand and modify its functionality. License Distributed under the MIT License. See LICENSE file for more information. Showcase
How to use the mod The mod has a custom UI that can be hidden when needed, and can also hide the crosshair (cursor). The mod adds a HUD on top of the game on the left side of the screen to show you various player stats.
The body figure in the bottom left corner is the health of the body parts.
The mod adds a spawn menu on top of the game on the right side of the screen with some drop-down menus and buttons. The mod also adds a few keyboard shortcuts to trigger its functions. Keyboard shortcuts of this mod Shortcut | Description -------------------+--------------------------------------------------------------------------- U | Show/hide the UI (HUD) of the mod Alt + U | Skip the death screen (only when dead) Ctrl + J | Try to resurrect the player (only when dead) . | Show/hide the crosshair I | Toggle Invulnerability on/off T | Toggle Super Strength on/off L | Spawn a loadout around the player + | Increase the current level of enemies - | Decrease the current level of enemies F1 | Spawn selected Armor F2 | Spawn selected Weapon F3 | Spawn selected NPC F4 | Spawn selected Object F5 | Undo last spawn (can be repeated) F6 | Despawn all NPCs B | Spawn the Boss Arena fence around the player's location (only the fence) K | Kill all NPCs currently on the map Z | Freeze or unfreeze all NPCs currently on the map M | Toggle Slow Motion mode [ | Decrease game speed for Slow Motion ] | Increase game speed for Slow Motion Space | Jump (at your own risk) Mouse Wheel Click | Shoot projectile Tab| Change projectile to the next one Shift + Tab | Change projectile to the previous one Ctrl + End | Possess the NPC closest to player Ctrl + Home | Possess the original player character NumPad 4/6/8/2 | Dash Left/Right/Forward/Backward * on NumPad | Pause/Unpause the game. Use that in Photo Mode to have free cam in battle + on NumPad | Switch player team to the next one - on NumPad | Switch player team to the previous one
Changing difficulty
Increasing and decreasing the level with + and - will affect the level of the auto-spawned NPCs.
"SuperStrength" makes your attacks with any weapon a bit better.
Invulnerability does not need much explanation. Regeneration is also applied when Invulnerable.
Note that the game itself (not the mod!) makes your player invulnerable for a first few seconds during spawn (maybe to avoid dying due to physics of the game?), and then removes invulnerability.
Changing teams
Press + or - on NumPad to cycle the player between available teams (0, 1, 2).
You can select any team for the player or for NPCs you spawn.
By default, the player is in Team 0.
Team 0 is "deathmatch": every NPC in Team 0 will be hostile towards each other and the player, even if the player is in Team 0. The player is in Team 0 by default.
Team 1 does not seem to be used by the game currently (but we can use it for the player and NPC we spawn). Team 1 does not attack Team 1.
Team 2 is all the auto-spawned NPCs and bosses. Move your player to this team if you don't want to be attacked by what the game auto-spawns against you. Team 2 does not attack Team 2.
The above can also be summarized as the following: the game treats everybody in Team 0 as "deathmatch", and Team 1 vs Team 2 is classic "team deathmatch".
Spawning things
You can either spawn a complete "chef's choice" loadout around yourself (press L),
or, first, pause the game, select what you want in the drop-down menu on the right, and spawn each individual item.
Use the buttons on screen to spawn items while the game is paused, or use F1 - F4 to spawn the selected things in each category (armor, weapons, NPCs, objects) when the game is running.
Player's viewpoint direction is used to place the spawned object in the world. NPCs are placed a bit further than items.
When spawning NPCs, you can select which team to spawn them in. By default, the NPCs spawned from the mod are in Team 0 (deathmatch, everybody hostile to everybody including the player)
The on-screen spawn menu also has a custom weapon size slider. With the checkboxes X/Y/Z, select which coordinate axes you want to apply the scale to. Z is the top-bottom axis, X is the left-right and Y is the front-back. Scaling proportionately gives best results for comedic effect, but sometimes weapons become too thick to grab for the player.
The names of objects in the on-screen spawn menu have been shortened for better readability.
Loadout configuration
To modify the pre-configured loadout that is spawnable with L button, edit the custom_loadout.txt text file in the data subfolder of the mod:
Mods\HalfSwordTrainerMod\data\custom_loadout.txt
It contains the list of Unreal Engine class names that will be loaded. Look around in the files in the \data\ folder for examples. Note that these are full class names, not the shortened ones on-screen. A default loadout is also hardcoded in the mod itself, in case the custom loadout file gets deleted.
You can also prefix the class names in custom loadout text file with the scaling factor, in round parentheses:
A single number in parentheses means equal scaling in all directions, three numbers is independent scaling in X,Y,Z order. The scale is optional, default scale is 1.0 == no scale.
Despawning things
Use F5 or the on-screen button to undo the last spawned thing. It can be used repeatedly to undo many things.
If you want to find a particular random variant of some item, select it in the menu, then go unpause the game, and repeatedly press the corresponding F1 - F4 button, and if you don't like it, press F5 to undo.
Killing NPCs
Use K or the on-screen button to kill all the NPCs that were spawned by the game or by you. May crash the game sometimes, but should work better now.
Freezing / unfreezing NPCs
Use Z the on-screen button to freeze/unfreeze all the NPCs that were spawned by the game or by you. Will not prevent new ones from spawning, or affect these new ones (until you try freezing/unfreezing them again).
Slow motion
Use M to toggle Slow Motion mode, and [ and ] to decrease and increase slow motion speed.
If Slow Motion is on, then the speed change will be applied immediately.
Otherwise, selected speed will be applied after Slow Motion is enabled
It may crash the game if you change the game speed too often or in the middle of a fight.
Jumping
Use Space to jump. There is a cooldown of 1 second to prevent flying into the sky and crashing down. Sometimes you may be able to jump higher, use at your own risk.
Jump does not work when the player is down on the ground.
Jump does not work well when changing the game speed.
Shooting projectiles
This is not a "true" throwing of objects, but more like shooting or launching them for maximum damage.
Use mouse wheel (click) to shoot a projectile, and Tab to change to next projectile type, Shift + Tab for the previous projectile type.
Shooting is more accurate in first person view.
The projectiles are currently hardcoded in the mod to account for scaling, launch position and speed adjustments:
Your currently selected weapon from the Spawn menu (including current scale!)
0.5x scaled spear
0.5x scaled pitchfork
dagger
small axe
mallet
stool
buckler
breakable barrel
bench
table
Your currently selected NPC from the Spawn menu (including current NPC team!)
WARNING! Launching NPCs may lead to a crash soon.
WARNING! Launching large objects like full-size scythes, spears, greatswords, polearms, etc. can damage the player!
WARNING! Beware of ricochets!
Skip the death screen
Press Alt + U to skip the death screen and unpause the game. You can still control the camera and enjoy the views, and apply the mod functions to the NPCs if needed.
Resurrect the player
Press Ctrl + J to attempt to resurrect the player (after you removed the death screen, of course).
Having exploded head or being decapitated still appears to be fatal in the current version, as are some other injuries.
Resurrection may be repeated as needed.
NOTE: You may need to activate Invulnerability before or after that, as some injuries will drain the health / tonus / other stats and kill the player again.
NOTE: Resurrection is known to break some of the mod's functionality, use with caution.
WARNING! NPCs may continue attacking the dead player, so be prepared.
Possessing NPCs
You can take control of other NPCs by "possessing" them
Press Ctrl + End to possess the closest NPC to the currently possessed one, and Ctrl + Home to jump back to the original player.
NOTE: Sometimes the NPC you possess may be bugged.
Pause/unpause the game to get free camera
Enter Photo Mode (press C), then enter free camera (press F), then press * on NumPad to unpause the game.
This allows you to use all filters and effects of the photo mode with the free camera while the battle is ongoing.
Together with player and NPC team selection and freezing NPCs on spawn or with a button (Z), you can set up team battles in advance.
Other good things
UE4SS also enables the Unreal Engine console, which can be shown by pressing F10 or @. It is useful to change video settings that are not exposed in Half Sword original UI.
When you know which settings you like, you can edit them permanently in the game's .ini files in %LOCALAPPDATA%\HalfSwordUE5\Saved\Config\Windows\Engine.ini or other config files in that folder (so most probably in C:\Users\%USERNAME%\AppData\Local\HalfSwordUE5\Saved\Config\Windows\)
Some examples of the settings you might want to change in those files (or in the console, on the fly) are, for Engine.ini:
UE4SS has a lot of useful functionality for game modders, read their docs and have fun.
You can open the UE4SS's graphical console, find Unreal Engine objects, and modify their attributes (like the score, for example).
Know issues and TODOs
No error handling whatsoever. Use at your own risk. It will crash the game at some point! Don't spawn too many things, or more than 10-15 NPCs, etc.
The mod's keybinds don't work if you keep holding down the game standard keybinds (like when running with A/W/S/D). Some keybinds have been modified to work while holding Shift or Ctrl, but may be unstable.
Auto-spawned NPCs and boss fights will keep spawning.
The custom loadout is spawned in the map, not on the player.
Freezing only freezes the bottom part of the NPCs, they can still use weapons on the player.
No ability to remove armor from the player.
No ability to modify the damage of your weapon or of NPC weapons yet.
No ability to spawn custom modular weapons yet (we spawn a random version).
No ability to un-glitch yourself (weapons stuck in slots, player body joints stuck in unnatural positions, etc.). Invulnerability helps, though.
No ability to fly (for jumping see above).
Possessing or un-possessing NPCs may leave them bugged.
If the game is unplayable at all, disable UE4SS or reinstall the game (whatever is faster/easier).
Mod does not load?
Make sure UE4SS loads and observe its logs. It should mention HalfSwordTrainerMod.
If it does not, check that you have the mod files in the right places as explained above.
If it does, but the mod does not show UI or does not react to the keyboard shortcuts, check the logs for errors related to HalfSwordTrainerMod.
I see the HUD/UI of the mod, but number values are zero, UI buttons don't work and drop-down menus are empty
If you are on UE4SS 3.x.x, check that you have patched BPModLoaderMod as described in the installation instructions above.
That means that BPModLoaderMod has worked correctly and loaded our Blueprint mod (that is the UI of the mod), but the actual Lua mod named HalfSwordTrainerMod can't work due to one of the possible reasons:
either it is missing in the Mods folder entirely,
or it is not copied in the correct folder structure (say, the Lua files of the mod must be in Mods\HalfSwordTrainerMod\scripts\),
or it is not enabled in the Mods\mods.txt,
or the mod cannot start due to some error.
Check which of these things might have happened on your system, and also look inside UE4SS.log and see if there are any error lines looking like [HalfSwordTrainerMod] [ERROR].
If you see:
HSTM UI version mismatch: mod version 0.x, HUD version 0.y
then you have copied different parts of the mod from different versions. Re-install the mod from the version you want as described above.
I see the HUD/UI of the mod, the numbers are correct and the UI buttons and drop-down menus work, but the keyboard hotkeys don't work
Unfortunately, this happens sometimes, usually a reboot helps.
I don't see the HUD/UI of the mod on screen, but some hotkeys still work
That means that the BPModLoaderMod did not work or could not find the Blueprint mod, and therefore did not load our Blueprint mod that is the UI, while Lua mod named HalfSwordTrainerMod succeeded.
BPModLoaderMod probably couldn't work due to one of the possible reasons:
either it is missing in the Mods folder entirely, probably with all other folders out of the UE4SS package
or it is not enabled in the Mods\mods.txt,
or the LogicMods folder is missing from \Half Sword Demo\HalfSwordUE5\Content\Paks, or its contents are wrong (e.g. wrong version of Blueprints in LogicMods, see above),
or the mod cannot start due to some error.
Check which of these things might have happened on your system, and also look inside UE4SS.log and see if there are any error lines saying something suspicious right after the line:
[2024-01-21 12:06:20] Starting Lua mod 'BPModLoaderMod'
Mod crashes the game?
If you suspect the fault is in the logic of this mod, you can try to disable or comment out the last suspicious thing that you used before the crash.
