File Details

Download this file | Go to files list

foxMod - Splitscreen v0.3
A Mutator and INI modification to support better splitscreen play through UI tweaks and re-written gamepad handling code
By foxUnit01 (foxBox)

------
Features
------
UI Additions:
-- Default to 2P Splitscreen option
-- Additional gamepad options
-- Additional bindable controls:
--- Add Splitscreen Player
--- Cycle Splitscreen Control
--- Show Base Path
--- Network Statistics
--- Screenshot
--- Toggle Duck / Dodge (Gamepad)
--- Weapon Picker (Gamepad)
--- Toggle Impact Hammer (Gamepad)

Splitscreen Tweaks:
-- Allow local players to tweak options (for current session only, see known bugs)
-- Automatic XBL guest-style player renames ("fox", "fox(2)", "fox(3)" instead of "Player258")
-- Automatically disable Music, Dialogue and Announcer when splitscreen active (see known bugs)
-- Allow local players to drop-in midgame via Add Splitscreen Player bindable control
-- Allow local players to drop-out midgame via "Disconnect" from the menu

Enhanced Gamepad Support:
-- Tighter looking and aiming controls, with adjustable quick-turn speed
-- Subtle autoaim and control tweaks for inputs received from a gamepad - gamepads can be used in tandem with a keyboard/mouse (features automatically toggle appropriately)
-- Revamped default control setup (see below)
-- All gamepad controls can be re-mapped from keys menu (some were mysteriously missing)

Source for the mutator comes pre-extracted in the src folder so you can laugh at my silly code.

------
Installation
------
Extract the archive to "DocumentsMy GamesUnreal Tournament 3UTGame". There should be no file overwrites if you've never installed the mod before. DO NOT place any files in your UT3 install folder.

To use the INI tweaks, navigate to the Config folder and delete UTGame.ini and UTInput.ini. When you next launch UT3, new files will be generated from the mod's DefaultGame.ini and DefaultInput.ini with the necessary tweaks.
(Note: This will not reset your profile settings! These modified INIs are also perfectly compatible with normal games not running this mutator)

Finally, to fix a few issues with the new controls not being saved, navigate to the Config folder and open up UTEngine.ini. Find the following line:

ProfileSettingsClassName=UTGame.UTProfileSettings

Comment this out and replace it with the following:

;ProfileSettingsClassName=UTGame.UTProfileSettings
ProfileSettingsClassName=UTMutator_foxSplitScreen.foxProfileSettings

------
Uninstallation
------
Simply delete all files that were extracted from the archive. Additionally, reverse your changes made to UTEngine.ini, and delete your UTGame.ini and UTInput.ini files (to generate new files from vanilla UT3's DefaultGame.ini and DefaultInput.ini).

------
Usage
------
You will need an XBox 360 Controller set to Player 2 or higher. If you only have one XBox 360 Controller (or have no controller and need to emulate it), you may be able to set it to Player 2 or higher using xbox360cemu - Code.google.com

You should notice several new settings in the options menu, particularly under the Input tab. Play around with these as you wish - it will not create any issues should you decide to uninstall the mod later.
If you would like to utilize the new default controls (and receive default keybindings for the new actions), simply click "Restore Defaults" on the Keys page and click Accept. When viewing the Keys page again, the new bindings should display.

To start a splitscreen game, you have two options - for a 2P splitscreen game, you can simply check the "Splitscreen" box under the Player tab, which will automatically set 2P splitscreen for Instant Action and Multiplayer games (on servers running this mutator). For more than 2 players, check the Keys page for an "Add Splitscreen Player" action. Once in-game, this key will add splitscreen players in order of viewports available.

Splitscreen players should be able to use the ingame menu like normal (unless the Vote tab is up, in which case the first player will have to enter the menu and cycle out of the tab first). If a splitscreen player chooses "disconnect" from the menu, it will drop only that splitscreen player from the game (unless it's the first player, which will disconnect the client as normal).

I have not tested this mutator in network games with remote clients, but it "should" work fine in servers running this mutator. I assume no risks involved in testing this functionality. :P

------
Default X360 Gamepad Controls
------
code:
-- Sticks:
Left Stick Movement
Right Stick Aiming
LS (Click) Toggle Duck / Dodge
RS (Click) Toggle Impact Hammer

-- Triggers / Shoulder Buttons:
Right Trigger Primary Fire
Right Shoulder Secondary Fire
Left Trigger Weapon Picker
Left Shoulder Jump

-- Face Buttons:
X Button Use / Toggle Translocator/Hoverboard
Y Button Select Next Weapon
B Button Select Previous Weapon
A Button Select Best Weapon

-- D-Pad:
D-Pad Up Titan Transformation
D-Pad Down Feign Death
D-Pad Left Command Menu
D-Pad Right Show Map (Warfare) / Show Base Path

-- Other:
Back Button Scoreboard
Start Button Show Menu

------
Known Bugs
------
Local players' profile settings do not save between sessions, including map transitions. Fixing this will involve lots of small hacks or rewriting the menu system, so I don't know how to attack this one yet.
Audio is buggy in splitscreen games, with each viewport playing its own audio (including music, etc.) - as a temporary workaround, music/dialogue/announcer volumes all force to 0 when multiple local clients are present.
Vehicle control type doesn't seem to function properly, even though the handling code is already in the individual vehicles themselves.
Auto-centering is a little strange and needs some work.
Probably lots of other things I forgot about!

------
Other
------
This is a small project I started on April 11th, 2012, only a few days before the original release. I've since worked on it here and there at my leisure - over time, I'd like to iron out all the bugs listed above and continue improving the controller support. If you have any questions or feedback (particularly with controller input!), I'd love to hear them - feel free to leave a comment on the ModDB page (http://www.moddb.com/mods/foxMod-Splitscreen/) or the Epic Forums thread (http://forums.epicgames.com/threads/910890-Splitscreen-Enhancement-Mod-PC) and I'll try to get back to you!

Thanks for trying the mod!
~fox

------
Changes
------
v0.3 (06/03/12):
-- Smoother aiming controls
-- Working analog stick configuration (Default, Southpaw, Legacy, Legacy Southpaw)
-- Reorganized controls menu (gamepad stuff grouped together down below)
-- Removed target adhesion / sticky aim (wasn't working correctly anyways)
-- Improved Auto-Center Look (much smoother and correctly centers to 0)
-- Auto-Center Look now defaults to off
-- General code cleanup

v0.2 (05/24/12):
-- Additional controls (such as Add Splitscreen Player or Show Base Path) are now saved properly.
-- When voting, any splitscreen players will automatically mirror the first player's votes.
-- Tighter quick-turn for controllers.
-- Removed extended FOV support; use FreeFOV or similar mutator for FOV tweaks.

v0.1 (04/16/12):
-- Initial release.

Download this file | Go to files list