
YES! THE ORESPAWN MOD REQUIRES FORGE.
YES! THE ORESPAWN MOD WORKS IN MULTIPLAYER.
YES! THERE IS A CONFIG OPTION TO CHANGE THE BLOCKID RANGE.
YES! THERE ARE CONFIG OPTIONS TO CHANGE THE ANT-WORLD IDS TOO.

OreSpawn uses BlockIDs in the range 2020-2600 by default.
OreSpawn uses WorldIDs 10, 11, & 12 by default.
You can change these in the config file if there is a conflict.
The config file is created in the .minecraft/config directory the first time you run it.

NOW WITH HOVERBOARDS!!!

GIRLFRIENDS(!), ANCIENT ORE SPAWN, URANIUM AND TITANIUM,
ULTIMATE SWORDS, ULTIMATE ARMOR, ULTIMATE BOW, EYE OF ENDER BLOCKS,
POPCORN(!),  CRITTER CAGES, LAVA EEL ARMOR, ENDERPEARL BLOCKS,
THE ULTIMATE FISHING ROD, MAGIC APPLES!, STRAWBERRY PLANTS,
FIRE FISH, APPLE COWS, MINER'S DREAM, AWESOME SOUND EFFECTS,
and whatever else I forgot... :)

Oh, yeah... CORN PLANTS, CORNDOGS, MOTHS, BUTTERFLIES,
MOSQUITOS, and, and, and, OMG... 

MOTHRA!

AND A FEW WHOLE NEW WORLDS!!!



*********************************************************************
READ THE USEFUL NOTES BELOW THE CRAFTING RECIPES!!!
*********************************************************************


Crafting Recipies: (VERY USEFUL MOD NOTES BELOW)

U = Uranium
T = Titanium
I = Iron
S = String
B = Bucket of Water
E = Ancient Dried Spawn Egg
R = Redstone
A = Apple
W = Wood of some sort
C = Cactus
G = Gunpowder
D = Diamond
. = empty


To Re-hydrate Ancient Dried Spawn Eggs:
...
.B.
.E.

Ultimate Sword:
.T.
.U.
.I.

Ultimate Pickaxe:
TUT
.U.
.I.

Ultimate Shovel:
.U.
.T.
.I.

Ultimate Hoe:
TU.
.I.
.I.

Ultimate Axe:
TU.
TI.
.I.

Ultimate Bow:
.TS
I.S
.TS

Ultimate Helmet:
...
TIT
U.U

Ultimate Chestplate:
I.I
TTT
UUU

Ultimate Leggings:
III
T.T
U.U

Ultimate Boots:
...
T.T
U.U

Ultimate Fishing Rod:
..T
.IS
U.S

Magic Apple: (OMG! No! Don't!!!!)
RRR    <---Redstone BLOCK
RAR    <---Redstone BLOCK (middle is an apple)
RRR    <---Redstone BLOCK

Critter Cages: (W = STICKS!)
IWI
W.W
IWI

Hoverboard: (W = WOOD PLANKS!)
...
WWW
DRD

Lava Eel Armor:
Crafted the same as regular armor, just use Lava Eels instead!

Moth Scale Armor:
Same as regular armor, but you have to kill Mothra first!
This stuff looks seriously cool!

PopCorn:
Put corn in the furnace.

Butter:
Two buckets of milk on the crafting table.

Salt:
Salt Ore in the furnace.

Buttered Popcorn:
Popcorn and Butter on the crafting table.

Buttered and Salted Popcorn:
Buttered Popcorn and Salt on the crafting table.

Bag of Popcorn:
Six Buttered and Salted Popcorn, plus three Paper on the crafting table.

Miner's Dream !!!:
CCC    <- Cactus
RRR    <- Redstone BLOCK
GGG    <- Gunpowder

Raw Corn Dog:
Raw Chicken, Raw Pork, Corn, and a stick.

Cooked Corn Dog:
Put a raw corn dog in the furnace.

Uranium/Titanium Blocks:
Eye Of Ender Blocks:
EnderPearl Blocks:
Same as any other ingot-type block. 
Put nine on the crafting table.

Apple Tree Seed:
Place an Apple on the crafting table.


Extreme Torch:
Coal, Redstone, and a Stick on the crafting table.


Web:
Eight strings arranged like wood for a chest will make you a spider web block!

Stairs Up:
..C	(C is cobblestone)
.CG
CGG

Stairs Down:
C..	(C is cobblestone)
GC.
GGC

Stairs Accross:
...	(C is cobblestone)
CCC
GGG



Important/Useful Mod Notes:
Important/Useful Mod Notes:
Important/Useful Mod Notes:

Critter Cages only work about 80% of the time. You may have to throw more than one.  Keeps things interesting.  And yes, they catch almost all types of critters, including dragons! Very useful to simply transport farm animals. Also handy against creepers. Warning though... they work better on some critter than others!  Just throw one at an entity/mob to catch it.  Right-click it on the ground to release the captured critter.

A bag of popcorn gives more health than just the popcorn that went into it.  No, you can't have just salt on your popcorn! Yuck.

Craft an Ultimate Fishing Rod and go fishing in Lava!!! You'll catch all sorts
	incedibly useful things. Including:
	Spark Fish
	Fire Fish
	Sun Fish
	Lava Eels
	and Sunspot Urchins.

Fish that live in lava provide fire protection and hunger points when eaten.  No, you don't need to cook fish that were caught in lava.  Yes, you can eat lava fish any time. You don't need to be hungy.

Lava Eels can be crafted into some pretty awesome armor.  Looks rather spectacular too, if you ask me! Seriously.  Lava Eel Armor is more durable than diamond, and fire resistant too!

Sunspot Urchins can and should be thrown! Try a few!

To use a Spawn Egg, after you've re-hydrated it, just right-click with it on the ground.
Ancient Dried Spawn Eggs can be mined/found only at shallow depths.
Ancient Dried Spawn Eggs are actually fun to collect, and to spawn upon an unsuspecting friend! :)
Ancient Dried Spawn Eggs have been updated to include all standard Minecraft critters. Can you find them all?

Uranium and Titanium can be mined/found only deep underground.
Uranium and Titanium require a diamond pick-axe to be mined. Yes, you need to find 3 diamonds and make a diamond pickaxe first. It's a pain, but believe me, it's worth it.
Uranium and Titanium ore blocks are 'entangled'. Hit one and they all sparkle!
Nine ingots of Uranium make a Uranium block. Same with Titanium. Cool, sparkley blocks...

Ultimate Armor is enchanted. Very useful. Awsome stuff and looks cool too!
Moth Scales can be crafted into some pretty darm cool armor too!
Did I mention the Lava Eel armor?

Yes. Yes you do want to make an Ultimate Sword. OMG. Way too cool.  In fact, you'll want to make two! One for you. One for your Girlfriend!
Ultimate tools wear out even slower than Diamond. But they seem to last pretty much forever. One of each is probably all you'll need.
Try an Ultimate Axe on a tree! Wow!

Right-click a Girlfriend with a Red Rose to tame her. May take more than one!
Yes. Yes you can. Unlike real life, you can make your girlfriend 'stay', and shut up!  Give her a diamond to hold. Presto. Silence... :)
Right-click with an item, and she will hold it.
Right-click with an empty hand, and she will return her item.
Right-click both with items, and she will trade.
No, she CANNOT use a bow. She throws shoes. Shoes are deadly against creepers.
Yes, you can throw shoes too.
Shoes thrown by Girlfriends will not hurt Players.
Just like real life, Girlfriends seem to have a infinite supply of shoes.
Yes, they can use swords! Give her one. Really. She won't hit you. Trust her.
No, armor would just mess up her outfit. A Girlfriend has 50 health points to make up for her refusal to wear armor.
Girlfriends will self-heal over time.
Right-click with food, and they heal appropriately.
Right-click with red rose, and they heal instantly.
Hold a red rose and they will follow closely.
Right-click with yellow rose, and she will change clothes!  There are 25 different outfits.
Right-click with yellow rose while wet, and she will change bikinis!  There are 12 different bathing suits.
Right-click with a Dead Bush to break up and untame them.
No, you cannot mess with someone else's Girlfriend! Jerk.
Girlfriends are immune to fire, because the code is too ridiculously complex and needs to be completely rewritten to avoid even simple things like cactus. That's why everything in the Nether is fire resistant too.
Girlfriends like to swim in lava.
Girlfriends will not drown, because the AI software doesn't always work right.
Girlfriends HATE CREEPERS and WILL ATTACK them!!!
Girlfriends are not perfect. Sometimes they miss a creeper or two.
Yes, you can take your girlfriend to the Nether:
	1. She will not follow you to the Nether, but...
	2. place blocks in front of the portal to make a level entrance.
	3. hold a red rose to bring her close to the portal.
	4. push her in!
	5. Get her back out the same way.
Sometimes Girlfriends may refuse to come back from the Nether, no matter what you do. Try shutting everything down and restarting.  This usually fixes the problem so you can get her back out.  It's not just girlfriends. Tamed cats seem to have this problem too.
You may (will!) find it helpful to build some sort of controlled access (like a door!) around your Nether portal to keep your Girlfriend from wandering in on her own. The structure of the base minecraft/forge code doesn't give me the ability to fix this problem.
Girlfriends do not attack Endermen, Zombie Pigmen, or other Players.  Yes, that means they work great in multiplayer!
Girlfriends do not usually attack things that you attack, or that attack you. Why?  Because she's not your Mother. You can take care of yourself.
Girlfriends are jealous, and will attack single girls that get too close.  Tamed girlfriends get along fine.
Yes, you can have more than one: be quick, and unarm your first girlfriend before trying to tame a second one!
Girlfriends are perfect as helpers for fighting and exploring caves!
Make sure you carry a few red roses for emergencies.
Girlfriends can be a bit annoying while mining, but will quickly get out of your way when accidentally hit with a pickaxe. Sometimes though, making a small room (4x4 square) for her to hang out, or simply going around her, is the only thing you can do.
Girlfriends are generally much quieter while mining, and will let you do your thing in peace.
Girlfriends follow closely when mining, exploring caves, and when it's dark outside.
She can go through open doors.
She will teleport to you if you get too far away.
Girlfriends whine when they are hurt, but will compliment and be nice when at full health.
Just place your crosshairs on your Girlfriend to see her health status. If you don't see her health status, then either you are too far away, or she is not your girlfriend.
If you don't like the skins provided, you can always download new ones from one of the many skin sites or make your own. Just rename and replace the skin files in the mod zip. Should be obvious how to name them.  girlfriend[1-25].png and bikini[1-12].png.
Dieing single Girlfriends drop shoes.
Dieing tamed Girlfriends drop red roses, shoes, and whatever they were holding.

Strawberry plants can be found in the forest. Yes, you can transplant them to your garden.
You don't plant strawberries, you plant the little strawberry plants!

Corn plants can be found in the plains. Wait until the corn ripens to harvest it.
Corn can be planted in your garden to grow corn plants.
No, bone meal doesn't work on corn plants. Tough noogies. They are worth the wait!
Corndogs have an amazing amount of healing/hunger power. I love corndogs! :)

Put a regular old run-of-the-mill apple on the crafting table to get yourself an Apple Tree Seed.
Right-click your Apple Tree Seed on a dirt/grass block to grow an Apple Tree!
Reap your rewards... then plant an orchard, and come back often to pick up the drops!

The Miner's Dream block is pretty damn cool! You've gotta try it! Make one. Take it underground, tap it on a stone block directly in front of you (not on a diagonal), and be amazed!

Extreme Torches are about 10% brighter than normal torches.

Mosquitos can be seriously annoying. There is a config option to turn them off.
Mosquitos spawn from mosquito plants, usually found in the swamp.
Moths are harmless, and spawn from Moth Plants at night.
Moths like to hang out near torches, just like real moths!
Butterflies are harmless as well, and spawn from Butterfly plants during the day.
Make a butterfly garden. It's relaxing and colorful...

Brown and Rainbow ants are fairly harmless. Red ants are not!
Salt blocks kill ants. Great for keeping ants out of places you don't want them!

Sky Trees are cool as shit! They're increbibly delicate. Break one log, and they all fall!
Sky Tree logs can be used to build all sorts of stuff, then one little hit, and poof!
Sky Tree logs turn into Oak Planks if you put them on the Crafting Table.
Need a lot of wood fast? Find a sky Tree. You'll only need one!

Did I mention the Duplicator Tree? See if you can find one. Place a block or two near the base. Just like having a Zerox machine...
Yes, you can chop down a Duplicator Tree and replant the logs on dirt blocks.  It will grow again!

Yes, you can give an Ultimate Sword to your Girlfriend. In fact, you SHOULD!!!
Ultimate Swords do only minimal damage to Players and Girlfriends.  (Yes, really. These things are so deadly I had to put code in to protect against accidents!) Although, you may still catch fire if you get hit...
Ultimate Bows (arrows) bounce off Players and Girlfriends for the same reason Ultimate Swords do only minimal damage. Otherwise, they're too deadly to use!
Ultimate weapons and tools may not appear enchanted at first (if you cheat and get them in creative mode). They will auto-enchant on first use.
Ultimate Bows will never run out of arrows. You don't even have to carry one in your inventory.
Ultimate Bows need only be 'tapped' on the right mouse button. They shoot fast, like a semi-automatic!
No, you cannot craft shoes. You may be many things, but Cobbler is not one of them.

Camarasaurus is tameable. They are about the cutest, friendliest little critters ever.  They don't do much except eat grass, leaves, vines, and cactus, but they do have a tendency to stick their nose in your face for a quick loving and trusting smooch.  If you want some warm fuzzies, then Camarsaurus is the pet for you.  Camarsaurus is found only in the Red Ant World. Red apple to tame. Cannot be un-tamed!!!  Tail speed indicates health and/or sitting.

Hydrolisc is also tameable. Pretty cool looking too! Keep an eye out for them in swamps!  These critters give you extra health points when you need them. Yes they do.  Watch your health bar next time you've got one of these as a pet and you get hurt!  Extremely useful when battling mobs. Better than a potion of regeneration...  They love water, and restore their health (and yours) quickly when in it.  Raw fish to tame. Dead bush to un-tame. Ruffles on the head indicate health.  Tail wagging indicates sitting or not.

Velocity Raptor is tameable too! He'll double your ground speed as long as he's your pet.  It's like having a permanent speed potion! Red apple to tame. Dead bush to un-tame.  Generally found only in random places in the Red Ant World. Feathers indicate health and/or sitting. Sometimes you need to click twice with an apple to get the speed effect. Sigh. It's java.

Spyro is tamable too. Though he's kind of annoying and catches everything on fire.  Raw beef to tame. dead bush to un-tame. Don't bother trying to kill him.  He's virtually indestructible. He should also be able to keep up with you when you're flying around in creative mode. Great little pal to have around, unless you don't like fire...

The WTF? eats stone. It's slow, and hates everything. But may be usefull if you're too lazy to mine yourself... Hey, what do you think made all those caves anyway?

CaveFishers are annoying.

Baby Scorpions are annoying too.

Dragonflies eat ants, mosquitoes, butterflies and birds!

Mosquitoes tend to follow you around once they get wind of you, just like real life!

Cryolophosaurus is annoying. But tastes like chicken!

Baryonyx just eats grass. Harmless, kind of like a cow.

How about that WaterDragon! Is he cool or what? :)

Attack Squids can cause temporary blindness... but they do have some nice rare drops!

And, that's about all I can remember at the moment... go. Explore!



***WARNING***

MAGIC APPLE - OMG! No! Don't even think about it!

	Hints (for those silly enough to try it anyway):

	Get far far away from everything. Very far. Very very far. 
	Out in the middle of the plains.
	Make sure no other players or anything of value is within at least 40 blocks!
	Put a torch on the ground at your feet. You'll need it. You'll be glad you did.
	Make sure you have a diamond pickaxe handy. Double-check your inventory.
	There is a small chance you may need it. Usually though, just a regular axe will do.
	Right-click the Magic Apple on a grass block NEAR YOUR FEET.
	If you don't get the 'poof' and visual effects, you didn't click a grass/dirt block.
	If you did, just hang in there and wait a bit. 
	DO NOT MOVE!
	The fans on your computer should be hitting overdrive about now.
	The surprise may take 10-20 seconds to generate. It's BIG. It's huge. It's MASSIVE.
	If you are on a server, it may even log you out. Wait a minute or two, then log back in.
	SURPRISE!  :)
	Did you look all around, and inside too? 
	The platforms on the sides are there for a convenient reason!
	Yes, there are a few random variations. Try it again!
	Did you get a sqaure one? Or was it more circular?
	It took a fair amount of work to make something this awesome.
	Hope you like it!


***WARNING***

Hoverboards are addictive too! Yeah man! Make yourself a hoverboard and hop on!  Right click to dismount. It will stay put by itself. Or attack with your hand until it turns into an item you can carry. Whatever. Once you get on, you really won't want to get off! All directions go forward. Just peel your finger off the "W" key and let it slow down by itself. Circle around as you slow down to land in a particular spot. Holding the shift key makes you go even faster. It's an aerodynamics thing...  Right-click with your Ultimate Sword to change colors. There are 10.  Want to try something really super cool? Find yourself a nice big steep mountain.  Yes, one from the Extreme Hills will do just fine. Go Ahead. Slam into that sucker at full throttle! Yeah. Trust the onboard automatic collision avoidance system to use that mountain as a gigantic ramp! Yowowowowow wow wow wow eeeeeeeeeeeeeee........  Yeah, you might take a little damage from too many g's from turning too tight or slamming into mountains, but who gives a ....? It's fun as ....!!!!! :) Oh, yeah... Take a compass with you! It's seriously easy to get lost real fast.



***WARNING***

If you happen to be taking a break from mining, and you're hanging out on the surface catching a bit of fresh air, and that surface happens to be in the Extreme Hills because you like Emeralds and that's the best place to find them... well, keep your eyes on the sky!  If you happen to see a huge dark shape up above... RUN LIKE HELL!!!

Mothra has a bit of a temper, and if you don't have fireproof armor and some sort of enchanted bow, well, you don't stand a chance. There is a reason not much grows or lives in the Extreme Hills... MOTHRA!!!

Mothra will not attack players who are in creative mode.
Mothra can be configured to be peaceful, in the config file.
Mothra has different attacks depending on the game difficulty setting.

Oh, and you might want to watch out for the Dinosaurs. They're not all friendly, you know.  Dinosaurs hate standard Minecraft mobs. But are they friend, or foe?

Did you try a Magic Apple? You should!
Did you try clicking an Apple Seed on the ground? You Should!
Did you try right-clicking the different ants? You MUST!
Did you try a hoverboard? OMG! It's mandatory! Slam it into a mountain! Yeah baby!!! Fly!!!
Did you find the Basilisk lair? The Maze? Go searching around the red ant world a bit.  Basilisk lairs have the best loot! Sometimes more than you can carry!  Entrance is on the surface. Kinda pyramid shaped...

Right-clicking a brown ant will take you to Utopia. It's a a beautiful world without mobs.  Well, yes, there might be a couple, but all underground. They don't spawn above ground.  And there are Wind Trees, that always point the same direction, so you don't need a compass!  And there are Sky Trees, which look like they grow forever and touch the sky!  And the Ginormous Trees. Wow... It's a beautiful, calming, peaceful world.

Bored with nice and calm? Try right-clicking a Red Ant. But bring clean underwear!!!  The mining is awsome in the Red Ant world. Tons and tons of stuff underground!  Mining like you've never seen it before, especially if you like Lapis Lazuli!  Oh, and yeah, almost forgot. Watch out for Dinosaurs!!!! ;) Don't forget to look up. That could be fatal too.  Or down. Or all around.  All sorts of stuff everywhere in the Red Ant World. It's just not a safe place.

Or perhaps you're tired of mining and fighting mobs? Try a Rainbow Ant.  Villages galore! Loot and pillage to your heart's content.

Yes, your Girlfriend and other pets will automatically teleport to the ant worlds with you.  Unless you've told them to sit, of course.

Did I mention the Duplicator Tree? It's kind of short. Looks like a small Oak Tree.  Place a block of your choice underneath it, and then wait. Or chop it down and plant all three logs on the ground and see what happens...

Be patient with the Ant Worlds. Sometimes they can take a while to generate the first time.  Java isn't the speediest of languages! After the initial generation, you should be ok. Just remember, it's not hung, it's generating... This can be especially long when generating a Brown Ant world the first time. You'll see why.

Birds and Butterflies just generally provide pleasant background video/audio.  They are harmless.



DISCLAIMER: As with anything Minecraft/Forge, and especially Java, nothing is guaranteed to work 100% of the time. In fact, some things may just refuse to work at all. Kind of annoying, but hey, I test the bejeepers out of my code. Not everyone else does.  In fact, much to my exasperation and dismay, spawning particles above lava just simply refuses to work. Grrr... Speaking of annoyances, here are a couple important
ones:

CAUTION: Teleporting between worlds is not 100% safe. There is a bug which steadfastly refuses to report the correct block ID for the position requested. In other words, you could end up buried in dirt or stone. Have a pick handy the first few times back and forth until you find a safe place.

CAUTION: Swapping items too fast with a Girlfriend can lead to mysterious loss of item.  Probably has something to do with packets getting out-of-sync with the server.  Wait a couple seconds between swaps/gives/takes.

CAUTION: Flying around in creative mode with your Girlfriend trying to follow you can lead to her mysterious disappearance. :(  Something loses the object.  Give her a diamond to hold first. Then she should stay put.

CAUTION: Magic Apples are addictive! :)

BEWARE: MOTHRA!

BEWARE: The Basilisk and his castle-maze in the Red Ant world! Look around on the surface for an entrance. It's super cool and full of loot! Though I should probably mention... You might feel your legs stop working when you battle the Basilisk! 

BEWARE: Of giant Emperor Scorpions in the desert. Nobody messes with the Emperor. Run. Just. Run.

BEWARE: The Alien... Yeah. The Alien. Not just any alien. But THE Alien.
	'Nuff said.


CREDITS: A big THANK YOU to those who provided models and textures! Yes, while not all of the critter models are my own, all the animation and entities that go with them are 100%. But again, thank you for your artistry, and here they are, not just pretty pictures anymore... they're... ALIVE!!!

AND EXTRA CREDIT to Jess for her fantastically vibrant voice!!!!



Enjoy!


Richard H. Clark




