KEGS-X Xbox

KEGS-X
General
Author	XPort, Madmab
Type	Computer
Version	6
License	Mixed
Last Updated	2023/10/12
Links
Download
Website

KEGS-X is an Apple IIgs/e/c/+ emulator port for the Xbox. Original by XPort.

Features

• Emulates Apple IIgs/e/c/+.
• Excellent compatibility - ported from KEGS.
• USB Keyboard support.
• ZIP support.
• Cheat system - Search/Create your own cheat codes (see readme).
• Favorites list.
• Netplay.
• Resizable game screen.
• 480p, 720p, 1080i support.
• Virtual Keyboard.
• Skin-able.
• Music Control Menu.
• Save Game management - Delete save game files.
• Save States (see notes).
• Samba/NetBIOS sharing support (read roms from your PC).
• Relax Network Sharing (read roms from your PC).
• Play MP3 or M3U playlists in the background (can also read MP3/M3U from across Samba/Relax shares).
• User definable save directory.
• Take in-game screenshots and display them on the game selection list.
• Auto-screenshot capture mode.
• Hardware filtering options.
• Graphics filters.
• Record/Playback feature. Record up to 10 minutes of gameplay.
• Every single in-game command is fully customizable on any of the four joypad controllers.
• Map any emulator or UI command to a single button or a combination of two buttons.
• Autofire capabilities for any emulator button on any controller.
• One-button combos.
• Traverse any directory on any drive.
• All UI commands (save state, load state, screenshot, etc) can be invoked from the Options/Pause menu as well as in-game via your customized joypad mappings.
• Can be invoked from a command-line to directly run a game from a front-end or dashboard and bypass the user-selection screens. (Only if the frontend or dashboard supports this feature).
• Can return to the launching program *if* the launching program supports this feature.

Media

KEGSOSX (KEGSOSX)

Changelog

v6

• Updated to madmab edition interface CFv1b43. See "Interface Changelog.txt".

v5b6

• Updated to madmab edition interface CFv1b37. See "Interface Changelog.txt". Note: I never updated the version number in v5b5 so even though it existed the menu said v5v4.
• Changes to the screenshot code to account for new directory layout when using "Extras menu" screenshot options.
• Modified drive loading code so that it is smarter about finding the images if they were moved to a different location from when the configuration save was made. Useful if you are using someone else's saves (like Bigby's save configurations) or you moved your files.
• Added preset controller ability to KEGS.
• Created three preset controller configs. Standard Joystick, Standard Analog and Standard Mouse. Standard Joystick is the default selected controller config. Standard Joystick will only be auto selected if no config for a game exists. This is to prevent wiping of controls for games where you may have configured the controller yourself. If you have not configured the controller I suggest going into the controller menu and picking standard joystick as your preset controller config.
• Fixed issue where I forgot to put in a screen transition after selecting/inserting a game disk. Whoopsie.
• Force Write-Protect option was reversed. Fixed. Whoopsie.
• Corrected starting speed text for 2.5 Mhz. It should be 2.8 Mhz.
• Game exit transition no longer displayed when game is autolaunched.
• Fixed an issue where changing or rotating disks while in-game was resetting the BRAM, thus messing up the SRAM file. Whoopsie!
• Fixed issue where backing out of a zip without selecting a file when using the "Insert Disk" option was not properly restoring the screen.

v5b5

• Updated to madmab edition interface CFv1b29. See "Interface Changelog.txt".
• Starting speed of "8.0 mhz" was not displaying when selected in the game configuration screen.
• Fixed an issue where moving the mouse up (prodos) was causing the mouse to disappear if the mouse acceleration was higher than 1.

v5b4

• Updated to madmab edition interface CFv1b20. See "Interface Changelog.txt".
• Disabled the internal configuration menu. Pressing F4 to bring up the emulators configuration options was causing the emulation (not the emulator) to get caught in a loop. You can set a games configuration by pressing "x" when selecting the game and you can change/rotate disks in the "in game" menu".

v5b3

• Updated to madmab edition interface CFv1b17. See "Interface Changelog.txt".

v5b2

• Updated to madmab edition interface CFv1b14. See "Interface Changelog.txt".

v5b1

• Updated to madmab edition interface CFv1b08. See "Interface Changelog.txt".

v5

Changes To KegsX Core:

• Core updated to v0.90.
• Savestates are kinda wonky (and questionable at best). The original x-port version has some (v0.71) but I have no idea where it came from because it is not part of the original source. A cursory glance at it reveals many potential "issues" that could crop up from using them. Here is a quote from the readme for the v1 release of this emu. "Save states only work reliably while you are playing the same game without restarting it. This means that while you are playing a game, you can save/load states all you want, but as soon as you reset the emulator or exit the game, those save states will probably not work anymore". My two cents on savestates. As long as you are playing a game that does NOT write to the disk and you have the right disks inserted in the right drives then odds are you will be safe.
• Given the full "Madmab Edition" treatment.
• Sorry. No dual-preview skin to support Xtra's. Not that there are any atm.
• Keys "caps lock" issue should be fixed (for those with real keyboards).
• New option "Start With Caps Lock - On/Off". This will hopefully help resolve any issues with mapping the xbox controller to keyboard keys. See next comment. Currently defaults to "On". Let me know if it would be better as "Off".
• Xbox controller mapping to keyboard keys may need re-evaluating due to the weird nature of how the apple's "capslock" key works. If anyone with better knowledge of the Apple wants to help me on this just send me a PM.
• User can now mount a disk in drives 1 and 2. Game loading is alot more fluid now. Emulator remembers which disks were loaded at game boot time. Press X on game load if you want to change these. This included a new menu option to display the disks in drives 1 & 2, rotate and change disks.
• Bram now stored in seperate files whose name is based on the ROM used (1 or 3) AND the slot the disks are inserted in. This allows you to set seperate "startup slots" for 140k, 800k, and disk images without having to worry about constantly reseting the "startup" slot from within the "control panel". See below on how to setup the "startup" slot in the "control panel". The easiest thing to do is copy the include BRAM??.ram files into your saves directory (usually "e:\saves\kegs\"). Or if you are a real masochist you can manually set them all yourself.
• In game "configuration" computer speed is changed based on disk size. Anything less than 140k will autoset to 1mhz. The rest will be 2.5. Border clipping is auto set as well based on the recommendations in the Kegs documentation. This can be manually changed if need be.
• New selectable speed added to game configuration menu "8.0mhz" works great for some of the slower games "Silpheed", "Out Of This World". Use at own risk.
• Controller setup stuff moved into it's own menu and also added to the "in-game" menu so that you can adjust the trim and "center" positions more easily.
• Added in trim adjustment for joystick X and Y axis. This is needed if you are running games at "8.0mhz" speed. For example "Silpheed" needs X and Y trim set to "-100" for the joystick to work right when running the game at "8.0mhz".
• Controller type can now be changed to "Analog Joystick". Currently mapped to the left analog stick.
• Added new config option "Joystick Center Position". Most games work with the default (127). However some prefer a different "center" position. Silpheed (139), Skate Or Die (101).
• Sound MUCH improved now. Stuttering should be gone now.

Interface Related Changes:

• Added a new "Dummy/Lockdown Mode Setting".. "Remove 'Shutdown Xbox' From Main Menu?" Yes/No. For those of you who are driven crazy because this option is there.

Credits

Special thanks:

• X-port for porting a great collection of emu's over to the xbox, releasing the source code, and answering my questions.
• Surreal CE team - Just because they are cool.
• Atariage (Albert in particular) - For providing a place for me to ramble on. For encouragement in general.
• Wimpy and Perr - For also providing a place for me to ramble and to make my goods available.
• Shout out to Hyper_Eye, SPPV, hcf, A600, Destronger, +T+, Neobomb, incrediclint, YRUSirius, Surreal CE team and all those who are honourable and keep the xbox-scene alive.
• Comments of support from various interested parties.

External links

• EmuXtras - https://www.emuxtras.net/forum/viewtopic.php?f=76&t=2382