===== OPL-PORT of Colecovision (ColemPS2 2.0) UniqueUserName's MOD =====

ColemPS2 version 2.0:
~~~~~~~~~~~~~~~~~~~~~

By Jum 2002-2016

This is a Colecovision emulator OPL-PORT for the PS2 (released with kind permission from Jum).

If you want to use ColemPS2 2.0 outside of OPL, please get the ORIGINAL at:
http://jum.pdroms.de/

If you need a newer version of OPL, get the CURRENT version at:
https://bitbucket.org/ifcaro/open-ps2-loader/downloads/OpenPS2Loader_0.9.3.zip


An updated version of Jum's PS2 port of the "COLEM" Colecovision emulator.
This version is coded to run off of a CD-ISO and used with OPL.
It has been tested with many game images and almost all run fine.
I'd say about 95% of the games are playable (if you include homebrew games in your collection).
(97.5% of the original games worked during beta testing = 151 now working, out of 155 games tested).


Getting Started (part 1):
=========================

1. Find a Colecovision BIOS rom "coleco.rom" (or one of the hacked Colecovision rom versions, which normally bypass the irritating 12-second title screen delay when the Colecovision boots up).

2. Find some Colecovision game images. Make sure that they are exactly 8K, 16K, 24K or 32K. (Some images have a 50-byte header added, and they don't work).

3. Follow the instructions for adding BIOS and games to the ISO.


PS2 Controller Mapping (in game):
=================================

PS2 DS Controller = Coleco Controls
         X        = Left  Fire button
         O        = Right Fire button
         L1       = 1 key
         L2       = 2 key
         R1       = 3 key
         R2       = 4 key
         TRIANGLE = 5 key
SQUARE + L1	      = 6 key
SQUARE + L2	      = 7 key
SQUARE + R1	      = 8 key
SQUARE + R2	      = 9 key
SQUARE + TRIANGLE = 0 key
         START    = # key
         SELECT   = * key (Star key)
         R3       = Options Menu

Press R3 to exit back to the Options screen.


PS2 Controller Mapping (game selection menu):
=============================================

         X  = Choose Game
         R2 = DOWN 10 Games
         R1 =   UP 10 Games
         L1 = Bi-linear Filter


The options screen allows you to choose between 3 controller "Modes":
Normal		- For games that use the Coleco Joystick
Turbo		- For games that use the Turbo Controller (eg: Turbo -Steering Wheel)
Slither		- For games that use the Roller Controller (eg: Slither -Trackball)


ColemPS2 2.0 Change List:
=========================

1. Tidied up the rom selector.

2. Removed extension (.ROM) from being displayed in ROM selector.

3. Merged in updates from Colem 3.6 source code.

4. Fixes to magnified sprite rendering.

5. Modified to work better in NTSC mode.

6. Render 5th sprite (DigDug title screen).

7. Fix to noise channel (colem 3.6 noise code).

8. Fix to beamrider background grid (colour 0 issue).

9. Fix to border / backdrop colour.

10. Turbo controller emulation.
- PS2 pad "keys" mapped to Coleco 2nd controller.

11. Roller controller emulation.
- "Spinner" Slither mode.
- PS2 pad "keys" mapped to Coleco 2nd controller.
- Slither, Victory, Wargames, Omega Race, Centipede.

12. PS2 dualshock key mapping to get all Coleco keypad numbers:
- Dualshock L1, L2, R1, R2, TRAINGLE for Coleco 1, 2, 3, 4, 5
- SQUARE + L1, L2, R1, R2, TRIANGLE for Coleco 6, 7, 8, 9, 0
- SELECT for Coleco *
- START for Coleco #

13. PS2 video mode changed to 284x240.
- "Zooms" the playfield slightly.
- Reduces borders slightly.
- Borders needed for same look at CRT TV.

14. Use R3 to get to options menu.


Compatibility:
~~~~~~~~~~~~~~

The below 151-games are currently known to be compatible with this version:

Please RENAME your games EXACTLY this way (copy/paste), to work with OPL as described and tested, AND to look really good (with full names) in your gamelist.

Gamenames can have spaces, will display as all caps, must be no longer than 26 characters, and no two games may have the same first 10+ matching characters (OR the first matching game will be loaded regardless of what you picked).

IMPORTANT:

Also, REMOVE any extension your images may have, such as .rom, .bin, .col, etcetera.
(Bulk Rename Utility is great for changing a whole folder in one click in mere seconds -bottom right in its interface).
If you require a physical CD, or an extension for some unforeseen reason, you may be limited to DOS 8.3 naming scheme (examples: BEAMRIDE or BEAMRIDR instead of its full name).

2010 GRAPHIC ACTION GAME
ALCAZAR FORGOTTEN FORTRESS
ALPHABET ZOO
AMAZING BUMPMAN
ANTARCTIC ADVENTURE
AQUATTACK
ARTILLERY DUEL
BASEBALL SUPER ACTION
BC 1 QUEST FOR TIRES
BC 2 GROGS REVENGE
BEAM RIDER
BLOCKADE RUNNER
BOULDER DASH
BRAIN STRAINERS
BUCK ROGERS PLANET OF ZOOM
BUMP N JUMP
BURGERTIME
CAMPAIGN 84
CARNIVAL
CENTIPEDE
CHOPLIFTER
CHUCK NORRIS SUPER KICKS
CONGO BONGO
COSMIC AVENGER
COSMIC CRISIS
CPK ADVENTURES IN PARK
DAM BUSTERS
DANCE FANTASY
DECATHLON
DEFENDER
DESTRUCTOR
DIG DUG
DONKEY JUNIOR KONG
DONKEY KONG 1
DR SEUSS
DRAGONFIRE
DUKES OF HAZZARD
ESCAPE FROM MINDMASTER
EVOLUTION
FACEMAKER
FALL GUY
FATHOM
FLIPPER SLIPPER
FOOTBALL SUPER ACTION
FORTUNE BUILDER
FRANTIC FREDDY
FRENZY
FROGGER 1
FROGGER 2 THREEEDEEP
FRONTLINE
GALAXIAN
GATEWAY TO APSHAI
GORF
GUST BUSTER
GYRUSS
HEIST
HERO
ILLUSIONS
ITS ONLY ROCK N ROLL
JAMES BOND 007
JOUST
JUKEBOX
JUMPMAN JUNIOR
JUNGLE HUNT
KEN USTON BLACKJACKPOKER
KEYSTONE KAPERS
LADY BUG
LEARNING WITH LEEPER
LINKING LOGIC
LOGIC LEVELS
LOOPING
MASH
MEMORY MANOR
METEORIC SHOWER
MINER 2049ER BOUNTY BOB
MONKEY ACADEMY
MONTEZUMAS REVENGE
MOON PATROL
MOON SWEEPER
MOTOCROSS RACER
MOUNTAIN KING
MOUSE TRAP
MR DO
MR DOS CASTLE
MS SPACE FURY
MUSIC BOX
NOVA BLAST
OILS WELL
OMEGA RACE
ONE ON ONE
PACMAN
PEPPER 2
PITFALL 1
PITFALL 2 LOST CAVERNS
PITSTOP
POPEYE
PORKYS
POWER LORDS QUEST
QBERT 1
QBERT 2 QBERTS QUBES
QUEST FOR QUINTANA ROO
RIVER RAID
ROBIN HOOD
ROC N ROPE
ROCK N BOLT
ROCKY BOXING SUPER ACTION
ROLLOVERTURE
SAMMY LIGHTFOOT
SECTOR ALPHA
SEWER SAM
SIR LANCELOT
SKIING
SLITHER
SLURPY
SMURF RESCUE
SOCCER SUPER ACTION
SPACE FURY
SPACE PANIC
SPECTRON
SPY HUNTER
SQUISH EM SAM
STAR TREK STRATEGIC OPS
STAR WARS ARCADE GAME
STEAMROLLER
STRIKE IT
SUBROC
SUPER COBRA
SUPER CROSS FORCE
SUPER DK
SUPER JUNIOR DK
TANK WARS
TAPPER
TARZAN
TELLY TURTLE
THRESHOLD
TIME PILOT
TOMARC THE BARBARIAN
TOURNAMENT TENNIS
TURBO
TUTANKHAM
UP N DOWN
VENTURE
VICTORY
VIDEO HUSTLER
WAR GAMES
WAR ROOM
WING WAR
WIZARD OF IDS WIZMATH
WORD FEUD
ZAXXON
ZENJI


Getting started (part 2):
~~~~~~~~~~~~~~~~~~~~~~~~~

ANY folder included, with "! !" surrounding the name of the folder, is telling you where to transfer its CONTENTS for use in OPL.

You will need:

A PS2 running OPL v0.9.3.
UltraISO (invaluable program you should have anyways).
A Computer (duh).
The files in this package.
Along with some Colecovision cartridge games (no games will EVER be included).
You must manually add your own games to the ROMS folder in the ISO (read the included "ADDING YOUR GAMES TO COLECO ISO..." file for steps).
Dont forget to add your BIOS or it wont work.


NOTE: IF YOU DO NOT HAVE A WAY TO BOOT OPL, THEN YOU CANNOT RUN THIS MOD OF ColemPS2 2.0 ON YOUR PS2 !!!


Adding your Games AND BIOS to the ISO:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

EXTENSION REMOVAL...

-----Steps (IF using Bulk Rename Utility):

1- "GATHER" all your games into a single folder.
(before renaming or removing extensions)

2- "OPEN" Bulk Rename Utility, and navigate to your games folder.
(press "CTRL + A", when you see the before/after window viewing your games)

3- Click the "DOWN-ARROW" next to the word "SAME".
(extension-11, in the bottom-righthand-corner)

4- Click "REMOVE", in the list that pops up.
(then click the BIG button in the corner, "RENAME")

5- Click the "DOWN-ARROW" next to the word "SAME".
(case-4, in the lower-middle-left area)

6- Click "UPPER", in the list that pops up.
(then click the BIG button in the corner, "RENAME")

7- "CLOSE" Bulk Rename Utility.
(RED "X" Tab, in upper-right corner of its-window)


NOTE: At this point in your games folder, there should be no ".ROM" extensions, and all gamenames should be "UPPERCASE".



BIOS...
(you must ALWAYS supply your own)

-----Steps (to ADD BIOS to the ISO):

1. "OPEN" the ISO with "UltraISO".
(resize its-window to the left-half of your screen)

2. "NAVIGATE" to where you have your "BIOS" stored.
(resize folder-window to the right-half of your screen)

3. "HIGHLIGHT" the BIOS you would like to "add".
(to Drag+Drop it into the same "ROOT" directory where SYSTEM.CNF is)

4. "DRAG+DROP" your BIOS into the ROOT of the ISO.
(while holding-down the Left-Mouse-Button)

5. "SKIP AHEAD" to step "#2" in the next section of "more steps".
(the list looks long, but youre actually almost done) :)



GAMES...
(you must ALWAYS supply your own)

-----More Steps:

1. "OPEN" the ISO with "UltraISO".
(you shouldve already done this if you were paying attention)

2. "DOUBLE-CLICK" the "ROMS" folder inside the ISO.
(to open up ROMS folder for the addition of games)

3. "NAVIGATE" to where you have your "games" stored.
(resize folder-window to the right-half of your screen)

4. "HIGHLIGHT" the games you would like to "add".
(OR Select-All with "CTRL + A")

5. "DRAG+DROP" your games into the ROMS folder.
(while holding-down the Left-Mouse-Button)

6. Click "FILES" Tab > "Properties", make sure "UDF" + "ISO9660" are checked.
(in UltraISO obviously... setting it as default, ONLY defaults for each ISO individually)

7. Click "OK".
(OR press "ENTER")

8. "Close" UltraISO.
(RED "X" Tab, in upper-right corner of its-window)

9. Click "YES", when the "Save-Changed-File" box appears.
(OR press "ENTER")


NOTE: The above instructions should work for most ISOs you make yourself or find on the net... however, if youre using one of my ISOs, there is a few more steps to get all the pre-set settings and coverart/backgrounds, that I will usually include...


-----Extra Steps:

10. "MOVE" the CONTENTS, of ALL folders in the zip, to where its !FOLDERNAME! says.
(ONLY the CONTENTS, of these special directing folders, NOT any !FOLDER ITSELF!)

11. "BOOT" OPL, and Launch your ISO from whatever menu corresponds to your device.
(ISO goes in "CD" folder on ROOT of USB... OR treat as a PS2 game if used in IHD)


-----Enjoy!


Credits by Jum:
===============

ColemPS2 is (heavily) based on Marat Fayzullin's "Colem" "portable" Colecovision emulator source code, so thankful credits are due to Marat.

Credits to the writers of the Colecovision tech docs, and the writers of the MESS Colecovision source code.

Many thanks to madcow (UniqueUserName) for motivating me to update ColemPS2, and for all his testing, glitch reports, and feedback.

Thanks to Guichi for the menu/select screen backdrop art. His name is off the bottom of the screen in NTSC mode.

Greets to all psx devers and ps2 devers.

- James Higgs   (aka Jum)


-----------------------------------------------------

FINAL NOTE from UniqueUserName:
===============================

Ive done my best with configuring this noob-friendly to work with OPL, updating this README, adding the compatibility list, and finally adding upto date instructions for OPL users (like that long list of steps lol).
I hope you like it!

Any feedback on this port...
Please contact UniqueUserName @PSX-SCENE.COM

===== This README updated in June-2016 by UniqueUserName, to apply to the OPL-PORT of ColemPS2 2.0, while retaining as much of the original README as possible =====