UMIPASTA

###Uku
My single map I have shown so far;
https://mega.nz/#!KR4kzLYR!tcATX7hFkYbMFUS4aaCCuJALAxFN7-2b5JjV3VW0A_k
You will need to import this into the Super Famicom Umihara Kawase ROM using the software Riverback.
https://onedrive.live.com/redir?resid=3CD90919322C51ED!9376&authkey=!AAEsN4VHGiuc5_U&ithint=file%2czip

###Mapping
It is in its infancy but thanks to collaboration between Karethoth, Nicole, Naulahauta, and Commando125 it is possible to make your own fucking levels. This is a major thread for this topic so I will be mirroring information from here;
http://kawasefan.net/forum/index.php?PHPSESSID=b28472e38246cecb2bedacb5beb8957b&topic=13.0

Here is a run down how.

Download the editing software Riverback (kawa, se);
https://onedrive.live.com/redir?resid=3CD90919322C51ED!9376&authkey=!AAEsN4VHGiuc5_U&ithint=file%2czip
And you will need to find the Japanese Super Famicom ROM

Open the editor and then "File", and "Open ROM" pointing to of course the Umihara Kawase ROM.
Once opened it will display the first level on the ROM. If you edited this and saved it to its own rom, your new level would replace this one.
First of all, under the "Show" category, check "Grid". You select tiles/physmaps with left click (and can select multiple by dragging with left click), and then paste with right click. Basic controls are;

"
• Dragging the mouse on-level shows instant preview of what it would look like if placed.
• Air tiles act as "transparent" (maybe this could be changed on context?)

Left click: select tile
Left hold: select area
Right click: paste tile/tile cluster
Right hold: "paint" with tile or tile cluster
Wheel click: de-select

ctrl + left/right: Palette
left/right/up/down: Select tile next to the currently selected tile in the tileset
1/2/3/4 (not numpad): View tileset/physmap/etc.
V: vertical flip
H: horizontal flip
O: object priority
D: deselect
Tab: Switch between editing tilemap and physmap
"
To delete a texture or physmap, select an empty slot in the selection section and then draw over the mistake with right click

There are two major editing modes which can be switched with Tab, Field and Physmap.

###Field
Field are the visuals, the textures, what the players see. You can change palette with the "Palette" selector and can flip the textures with the checkboxes. There are 8 palettes that can be accessed by a level at any time, 0 being no color at all, 1 being a more aesthetic color. The last 6 palettes are decided by the "Palette indices" section in Level Header Editor, the tab next to Field Display. Each block belongs to their respective palette, the first block being palette 2, the last being palette 7. Your options are 1-9 and A-F (be sure to always click "Apply"), each giving an entirely new pool of colors. There is also an option to change your texture bank, which are entirely different sets of textures, by going into Level Header Editor, choosing a bank, and then clicking "Apply".

#Texture prostratz
Direction sensitive textures (escalators for example) have a pattern. They are usually one atop another in the field tiles, top being turn right and bottom being turn left.
Escalator tract with thinner strips is visually slower.
Shading is always done as if the sun was in the top left, the artists designed the textures with this in mind and it wont work if you try the other direction (problems will occur at sides, you would see)
Water is unnecessarily flickery

###Physmap
Physmap are what gives these textures character, like being solid or being able to climb. It has its own tab next to "Field Tiles" and most of it are byte values.

Note, this all is confusing, I really recommend if you don't understand upcoming information to read the thread;
http://kawasefan.net/forum/index.php?PHPSESSID=b28472e38246cecb2bedacb5beb8957b&topic=13.0

Also I will try explain some more confusing things later and give examples.


"
Physmap bytes:
• 00: Air

• 01**: always a word where the first byte implies that an action will happen when the player pushes up and the second byte implies what the action is:
Where ** is:
00: climb a ladder
01: enter first door
02: enter second door
03: enter third door
04: enter fourth door
05-FF: the game will crash
NOTE: There can also be only one door instance (0101 or 0102 etc.) per level or the game will crash.

• 02** and 03**: always a word where the first byte implies direction and the second byte implies sprite number (up until 06).
02: sprite is facing left
03: sprite is facing right
Where ** is:
00: Player starting position (There can only be one. If there's two instances of 0200 or 0300, the game will crash)
01: sprite 1
02: sprite 2
03: sprite 3
04: sprite 4
05: sprite 5
06: sprite 6

• 03 07: Spawn-safe area. Enemies killed cannot respawn here. (special case, has nothing to do with sprites or facing left or right)

04: ?

05: If the field's sprite 05 is a bird, they can land in this spot.
06: If the field's sprite 06 is a bird, they can land in this spot.
It would be wise to remember that if you use birds in your levels, set them to slots 05 or 06. Setting them to 02 and 03 will cause a conflict and the game will crash.

For object values, there are 7 spots it can go in. Each spot I think affects tiles $01-$07, $39-3F, $41-47 respectively.

I'm going to work on the enemies first.

object values:
0x00: nothing
0x04: escalator slow right. animates palette 7.
0x05: escalator slow left.
0x06: escalator fast right
0x07: causes death
0x08: rising platform series (bank 0)
0x09: falling platform series (bank 0)
0x0B: pullable/moveable wall
0x0C: door
0x0E: downward pillar
0x0F: upward pillar
0x10: pop-out ceiling tile
0x11: pop-out ground tile
0x18: bridge piece
0x19: bridge piece. collapses when touched.
0x20: single platform (bank 0, white)
0x21: single platform (bank 0, blue)
0x22: waves can push you on platform $41-$47. slippery.
0x26: rising platform series (bank 0, blue, way less frequent)
0x28: boss door barricade
0x29: causes death
0x2A: ice/glass
0x2B:
0x2C: rising platform series (bank 4)
0x2D: falling platform series (bank 4)
0x2E: rising spiked platform series (bank 4)
0x2F: falling spiked platform series (bank 4)
0x30: rising platform series (bank 2)
0x31: falling platform series (bank 2)
0x32: rising spiked platform series (bank 2)
0x33: falling spiked platform series (bank 2)
0x34: single platform (bank 1)
0x35: single platform (bank 5)
0x36: rising platform series (bank 1)
0x37: falling platform series (bank 1)
0x38: single platform (bank 6)
0x39: single spiked platform (bank 6)
0x3A: rising platform series (bank 5)
0x3B: falling platform series (bank 5)

word values: enemy spawn rates (14FF being most common spawns, 7878 being least common behind 0000 of course)
0x0000: nothing
0x14FF:
0x1E96:
0x1EA0:
0x1EB4:
0x2864:
0x2896:
0x28B4:
0x3278:
0x328C:
0x32B4:
0x32DC:
0x3C64:
0x3C78:
0x3C96:
0x3CA0:
0x3CB4:
0x3CC8:
0x3CDC:
0x4650:
0x5046:
0x5050:
0x5064:
0x5078:
0x508C:
0x5096:
0x50A0:
0x50B4:
0x5A78:
0x6428:
0x6464:
0x648C:
0x783C:
0x7864:
0x7878:

enemy values:
0x00: nothing
0x01: "Poof"-sprite, crashes alone
0x02: "Splash"-sprite, crashes alone
0x03: net spawner (byte before this is what's dropped)
0x04: goldfish
0x05: eel
0x06: flying clam
0x07: brown snail
0x08: bucket, type 1 (byte after this is what's spouted)
0x09: bucket, type 2 (byte after this is what's spouted)
0x0A: flying fish (for bucket)
0x0B: small fish (for bucket)
0x0C: UNUSED. Puffer fish.
0x0D: blue fish
0x0E: "Poof"-sprite, crashes alone.
0x0F: red egg-laying fish
0x10: shark (byte after is what's thrown)
0x11: shark bait, also can be on ceiling
0x12: giant tuna fish
0x13: squid (horizontal) (byte after this is what's spitted)
0x14: squid (vertical) (byte before this is what's spouted)
0x15: squid ink
0x16: tiny fish in water (decorative)
0x17: brown bird
0x18: blue bird
0x19: "Poof"-sprite, crashes alone
0x1A: "Poof"-sprite, crashes alone
0x0B: "Poof"-sprite, crashes alone
0x1C: barnacle (ground) (byte after this is what's spitted)
0x1D: UNUSED. barnacle (vertical) (byte after this is what's spitted)
0x1E: UNUSED. blue barnacle, spits cannonballs
0x1F: barnacle spark
0x20: UNUSED. blue barnacle
0x21: blue snail
0x22: UNUSED. octopus (identical?)
0x23: UNUSED. catfish
0x24: "Poof"-sprite, crashes alone
0x25: "Poof"-sprite, crashes alone
0x26: "Poof"-sprite, crashes alone
0x27: "Poof"-sprite, crashes alone
0x28: "Poof"-sprite, crashes alone
0x29: "Poof"-sprite, crashes alone
0x2A: "Poof"-sprite, crashes alone
0x2B: "Poof"-sprite, crashes alone
0x2C: "Poof"-sprite, crashes alone
0x2D: "Poof"-sprite, crashes alone
0x2E: "Poof"-sprite, crashes alone
0x2F: backpack (1-up)
0x30: giant tadpole (boss) (put 0x31 and 0x36 after this)
0x31: frog (for boss)
0x32: giant seahorse (boss, enemy #3) (put 0x33 and 0x35 before this, 0x34 after this)
0x33: vertical seahorse (for boss)
0x34: small seahorse (for boss)
0x35: giant ink (for boss)
0x36: frog egg? (for boss)
0x37: giant crab (boss) (put 0x38 and 0x3D after this)
0x38: crab's bubble (for boss)
0x39: tiger flying fish (boss) (put 0x3A after this)
0x3A: tiger flying fish second formation? (boss)
0x3B: flounder flying fish (boss) (put 0x3C after this)
0x3C: flounder flying fish second formation? (boss)
0x3D: crab's platform shrapnel (for boss)
0x3E: "Poof"-sprite, crashes alone
0x3F: "Poof"-sprite, crashes alone

#Physmap protipz
Always press apply after you've changed something on the Level Header Editor tab, and THEN press save.
The lower water height or spawn rate numbers are, the higher they are (0 water covering half the map, and enemy spawn 14FF covering the WHOLE map)
If your map doesn't load, it is always something relating to physmap.
Many physmap tiles aren't actually used for anything at all.
Objects such as escalators and spikes must be referenced in the object types section under Level Header Editor (check official maps for some great references)

###SO, what the fuck does this all mean?
First of all, much of these values now have an icon so you cannot see some numbers in this list. Basically these hex values do what you want when you put them places.

For example, to make an area spawn safe, so you wont have to worry about enemies spawning in that area, you go to the Physmap Tiles and paste 03 and 07 next to one another (making sure it ends in 07). So 0307.
You can even make it so no enemies randomly spawn at all by just changing the enemy spawn rate to 0000 (i know some people really dislike this so I can see a mod taking this behaviour away happening in favor of static enemies)

To make a door usable, you would place 0101, first 01 being the instruction to interact with UP DPAD, second 01 being FIRST DOOR.
You can loop levels by pointing a door back to the level you want to loop to, could be useful for exploration like levels with a hub?
To end the game you make a door and point it to field 255, which will roll the credits once the player enters it.

However some information requires a 00 at the end, but since it means nothing you dont actually need to put it. For example, level 0, the spawn area is full of NO SPAWN flags (0307), but immediately above this is 03 by itself. In this case the spawn flag is 0300, 03 itself means face right (02 would be face left, this is for spawn directions) but 00 isn't necessary. Another example is the ladder, 0100. It is only 01.

Enemy creation is different, to spawn an enemy in a specific spot to never despawn you need to travel to the tab next to the Field Display section called the Level Header Editor. Enemy types are the numbers corespondent of the list up above, like level 0 enemy types are 04 (goldfish), 07 (brown snail), and 17 (brown birds). What this doesn't show you is these are taking up sprite numbers too. This is how you would choose spawns. 4 is in sprite 1 (the first section of 6), so goldfish will spawn facing left where you would write 0201.

But what about other objects? They also have their own sections beneath the previous enemies section. There are 7 slots. If you go to level 11 (level 9 in the editor), there are a series of platforms. It will show the object 20 (single platform, white) and 21 (single platform, blue). They are under the 6th and 7th categories, so while I don't know how to deal with this yet I assure you this is related.

For levels, like level 2, with a tutorial involving an enemy, there has to be an enemy in their slot or the level will hang. It doesn't have to be the original enemy, for example you can replace the eel with a goldfish and it wont break, but I imagine this potentially could.



###Basic stats (counting from the block from the floor the character stands on to where the player makes contact, probably not accurate)
Is 4 blocks tall
Can jump up 4 blocks high (without climbing)
Can climb up to 6 blocks high
Can jump up to 8 blocks across, climb or otherwise, providing both platforms were on the same level
Without having to climb she can fling herself 12 blocks and continue this speed indefinitely
She can fling herself 14 blocks (hooking the ground immediately beneath, pulling back, run and release)
Her hook can reach 17 blocks high
Her hook can reach 19 blocks high if she jumps mid execution
Her hook can reach 16 blocks from either left or right
Her hook can reach 14 blocks down

###Troubleshooting, quirks, problems, inconveniences, list of crap I feel like should be mentioned for whatever reason
#Game
There are certain levels that don't exist and will just be level 1 repeated over again.
For some reason levels wont load with certain enemy combinations. When you use the catfish (23) you will only be able to have one additional enemy. Don't know about enemies that spit bytes, but you cant have an additional eel AND goldfish for example.
More than one player spawn, doors with the same numbers, and enemies spawning too close to the ground will crash the game.
If there is an enemy in the starting tutorial graphic (level 1 (2) for example) there NEEDS to be an enemy in that slot. Doesn't have to be the original enemy, but this could introduce funny problems.
Make sure enemy and player spawns are at least 1 block above the ground or they will either not spawn or will spawn stuck in the ground.

#Editor
You cannot press 1 - 4 in selection boxes, these keys are alocated as the "Show" section hotkeys (if you have a keypad you can use that though).
You cannot preview where you will paste things you have copied on the field display (left click drag + right click)
You cannot select more than one texture at a time in the Field Tiles section
There is no fast right escalator (game issue?)
Physmap bytes 45 and 47 share graphics but don't appear to do the same thing, escalator (4) will work with byte 47, not byte 45 (though this might depend on object slot in object types used).
Escalator slow right will only work in object field 7, escalator slow left will only work in object field 6. This is the same scheme for a lot of objects, be sure to read the numbers below the object slots as they should match what you are trying to do.
If you make a level and export it, then import the level, it will always replace the level it was initially on AND the current visible level. If you delete textures or physmap on one level it will affect the other, this may be a problem with the game engine as it appears in several other level slots with level 1.

###Last thread
http://pastebin.com/qgdAWeKp