Log In
Name:
Pass:
Online Members (0)
No members are currently online.
Current Interguild Time:
Sat May 4 2024 3:10 pm
Member Chat Box  [click here to enlarge]
Recent Posts and Comments
ShareThis
« Blogs Index < Game Guides < HATPC Guides < Beginners' Guides
« Livio's Blog

This page is a beginner's guide on how to get started with the game Hannah and the Pirate Caves (HATPC). The first thing you need to do is to make sure that you can play the game. HATPC is a fairly old game and it does not work fully in all browsers. You can learn more about these issues in the following brief guide: Can't play Hannah and the Pirate Caves? Here's how to fix it.

How to Play

The game does a great job of teaching you how to play the game through its tutorial levels. To play them, click on "Play Game" in the main menu screen, and start at Tutorial 1.

How to Play Other People's Levels

So now you want to try some user-made levels, but you have no idea how to do it. Here's how it works: the game can only load levels that are uploaded straight to neopets.com, but you may only have one level uploaded to your account at once. So if you wanted to play a level, you would have to take the level code, go to the Cave Upload page, upload it to your account, then in the HATPC main menu go to the "Load User Level" screen, and type in your account name. The game will pull up whatever level you have uploaded on it and you will then be able to play it.

Sure sounds like a big hassle, right? When most people release their levels, it is common practice for them to have it already uploaded to their own account so everyone can more easily play it. Many of us also create several accounts on neopets.com so that we can have many levels uploaded at once. However, be aware that the site will automatically block the creation of new accounts if the same email address is already in use by five other accounts.

How to Make User Levels

CaveMaker is the program that you must download in order to make HATPC levels. The owner of the game, neopets.com, offers this program for download, but it is riddled with glitches and can be frustrating to use. Instead we recommend that you download the Interguild's CaveMaker made by member canadianstickdeath. The rest of this tutorial, as well as subsequent guides about HATPC, will be based on the Interguild's CaveMaker, which can be downloaded through the following link:

Requirements:

  • You must have the latest version of Java on your computer for this to work. You can quickly download Java by visiting the Java website.

How To Download:

  1. Click on the link.
  2. Choose to Open the zip file.
  3. Click the large "Extract To" button near the top-left of the window.
  4. Choose a folder to extract the files to. It is advised that you extract them into a new folder. Then click OK.

How To Open:

  1. Alert: Windows 7 users, please click here!
  2. Double click on the CaveMaker.bat file to open it.
  3. A black command prompt window will open. Wait until the CaveMaker window opens.
  4. Once the window opens, the black window will stay open. Closing it will also close the CaveMaker window and vice-versa.

If you have any issues getting the program to work, please post a comment at the bottom of this page.

Using the CaveMaker

When you open the CaveMaker, you can create a new file by going to File > New or by pressing Ctrl+N. The black grid in each file is your work area, and the list of tiles on the right side of the screen is what you use to add objects to the grid. It's fairly straightforward.

Changing Your Level Properties

You can change the properties of your level by going to File > Level Properties, or by pressing Ctrl+L. You can then edit the title, terrain type, water type, and dimensions of your level.

The title of your level must be no more than 20 characters. You are only allowed to use letters, numbers, and underscores. You are not allowed to use any other characters or spaces. There was a time when you could actually use any characters you wanted to, but for no reason neopets.com is now blocking levels that use characters like that, as if it was causing a glitch or something when it wasn't. Technically, you can use apostrophes without getting an error, but any apostrophes in your title will just be deleted. You can leave your title blank and the CaveMaker will automatically make it a single apostrophe for when you upload it. This is a good way to trick the game into letting you have a blank title.

As for your dimensions, the character limit for your level code is 8,000 characters. One may falsely assume that all they have to do is make sure the mathematical area of their dimensions are less than 8,000. However, ladders count as two characters, and return at the end of each line in the code also adds to the character count. It also depends on some of the level code settings you have set, which I will explain later.

The terrain type option lets you pick how the terrain in your level will look like. The water type option lets you pick between clear, murky, and dark water. Both the terrain and water options do nothing more than change the appearance of the two elements, so don't make the common mistake of assuming that murky water is poisonous, because it isn't.

Options > Allow Multiples

You can turn this feature on or off for the various tiles that are listed under it. If it is unchecked, placing more than one of such tiles will automatically erase the previous instance of that tile in your level. It's very convenient for helping you avoid uploading errors. By the way, the reason Enemy 4 is on the list is because it is impossible for the game to load more than one Enemy 4 per level. It is unclear why, however, so we assume it's just another dumb glitch.

Options > View-Text Formatting

The "Add Terrain Border" option will automatically add a one-tile border of terrain around your level. Be aware that this option is automatically checked, and it could bring you over the character limit if the dimensions you set originally were very close to that limit.

The next two options are meant to help sneak your cave past the uploader if it meets any of those criteria, which would normally trigger an uploader error. These options can affect your level code, but it will not affect the final level when you play it in HATPC.

Uploading Your Level

For more in-depth information on other parts of the CaveMaker, or if you have any questions, click here. Once you've made a level, you'll have to upload it to neopets.com, which requires that you create an account. If you still haven't made one yet, click here, and don't worry about getting your account activated (which means you don't even need to give them your real email) and ignore the step that tells you to make a pet. Neither are required in order to upload caves. Once your account is made, go to the Cave Upload page.

Go back to CaveMaker and go to Edit > View Map As Text... or press Ctrl+T. You will see a box open with the coding for your level. You can press the "Copy" button to copy all of the coding automatically. Then go back to the Cave Upload page and paste your coding into the text box. Click submit and you have uploaded a level. To play it go open up HATPC, go to "Load User Level" and type in your username to play your level.

Uploading Errors

It is advised that when you get an error, DO NOT fix the error right away within the code that the page gives back to you. The code may have un-removed backslashes ( \ ) within its code, and resubmitting it will add even more backslashes which will cause the game to read your map incorrectly. Instead fix the glitches in CaveMaker and then re-paste your text. Anyway, the following is a list of possible errors that the uploader might block you off for:

"Please use only letters, numbers and underscores in your Cave Name." OR "No map name provided."

If you get the first error, it means that you used spaces in your title or any other character that is not allowed. The second error means that you did not provide a title at all. If you want your cave to have no name, you can simply leave its title as a single apostrophe.

"Invalid terrain type." OR "Invalid background type." OR "Invalid water type."

Either the Uploader did not find the part of your coding reserved for defining these types, or you set them to something invalid. As for the "background type", there is only one background type, and that is "background 1", so ignore that.

"This map does not contain a starting position." OR "This map does not contain a door."

This means that you did not set the starting position or the door for your level. Our CaveMaker automatically stops this error by adding the starting point and door to the end of the code, which the game will later automatically load both at the top-left-most corner of your level. Note that when the door is placed there, it is impossible to enter it.

"Maps may only have 1 starting position." OR "Maps may only have 1 door." OR "Maps may only have 1 water level."

This is what happens when you add more than one starting point, door, or water level, but our CaveMaker keeps this error from occurring.

"Maps may only have 1 gem crate." OR "Maps may only have 1 life crate."

These errors mean that you used the characters "G" or "L" multiple times in your map. But you'll probably never see these errors because our CaveMaker automatically uses the lowercase characters "g" and "l" instead, thus dodging the errors and letting you use as many gems and hearts as you want.

"Map size is too small. 256 characters is the minimum (16x16 grid)."

This means that your map's dimensions are too small and that you must have a minimum mathematical area of 256. They even recommend a standard size of 16 tiles wide and 16 tiles tall. But our CaveMaker prevents you from getting this error.

"Map size is too big. 8000 characters is the maximum (90x90 grid)."

First of all let me say that 90 times 90 is NOT 8000. The recommended grid size should have been 88x88. And the reason I say that (as opposed to 89x89) is because the 8000 character limit counts returns (new lines) as two extra characters per line. Not only that, but after submitting the level code, the page adds backslashes (  ) before all apostrophes (which will get removed anyway) and quotation marks (which represents the tile for ladders), and that backslash adds even more to the character count of your map. Our CaveMaker tries to prevent this error when it can.

"Failed profanity check."

This is what happens when you get stopped by neopets.com's word filters for using inappropriate language. DO NOT TRY TO TRIGGER THIS ERROR. It will automatically ban you!

Learn More

Now that you know the basics of HATPC, I recommend that you look through several of the other HATPC guides we have on this site. The best part of this game, as may say, is the ability to manipulate all of its glitches to your liking. It may be helpful to look through the List of HatPC tricks and glitches, which is an index of everything that we have found so far. Anyway, that's it for this guide. If you had any questions or problems, please comment below.
[?] Karma: 0
User Comments (43)
« Forum Index < The Hannah and the Pirate Caves Board
«Previous | 1, 2 | Next»

Yaya
[?] Karma: 0 | Quote - Link
Thursday, October 29 2009, 8:40 pm EST

Age: 29
Karma: 747
Posts: 5367
Location: Ohio (US)
pm | email
It was broken in the 1st place.



COMING SOON: A giant meteor. Please.
Give me +karma. Give me +karma.
Harumbai
[?] Karma: +3 | Quote - Link
Thursday, October 29 2009, 11:08 pm EST
[|]-X-[|]

Age: 30
Karma: 260
Posts: 1743
Location: New Zealand
pm | email
Haven't you realised yet that lots of things seem really cool on this site until you find out most are broken in some little way.... Or in a major way......Like.....The......More Topics button.


Upcoming HatPC level: Sanctuary, coming soon to an internet browser near you...
snowman
[?] Karma: 0 | Quote - Link
Friday, October 30 2009, 1:29 am EST
I am a person.

Age: 25
Karma: 38
Posts: 1209
Gender: Male
Location: Singapore The Lil' Red Dot
pm | email
yeah, more topics is a fail.

Could have linked more topics to a list of all unread topics that haven't been read by you, if that's possible.'

If not, EPIC FAIL.






Harumbai
[?] Karma: 0 | Quote - Link
Friday, October 30 2009, 4:31 pm EST
[|]-X-[|]

Age: 30
Karma: 260
Posts: 1743
Location: New Zealand
pm | email
Join the club:

Quirvy was the first member, but he has become less active in campaigning for the rights of buttons with disabilities.

I am the second member who is most active in campaigning at the moment.

You can be the third member if you want.

Admittedly this isn't the most exciting club.


Upcoming HatPC level: Sanctuary, coming soon to an internet browser near you...
Yaya
[?] Karma: 0 | Quote - Link
Friday, October 30 2009, 4:53 pm EST

Age: 29
Karma: 747
Posts: 5367
Location: Ohio (US)
pm | email
Quote:
buttons with disabilities.


Lol, I imagined shirt buttons in a wheelchair. Even though it's a great metaphor to compare the state of the Interguild to sometimes, I really doubt it'll be changed any time soon.



COMING SOON: A giant meteor. Please.
Give me +karma. Give me +karma.
Quirvy
[?] Karma: 0 | Quote - Link
Friday, October 30 2009, 10:56 pm EST
  

Karma: 655
Posts: 7753
Gender: Male
pm | email
The moment I clicked that button... I was like, "WTH? Is this a broken link or something?!"

I'm not saying it should be a major priority, but it definitely needs to be made into something useful, or just removed.



spooky secret
canadianstickdeath
[?] Karma: 0 | Quote - Link
Saturday, October 31 2009, 5:29 pm EST

Age: 35
Karma: 350
Posts: 2990
Gender: Male
pm | email
I'm probably in the minority here, but I like that there's some indicator that I haven't read all the new topics... The more topics button is probably a stupid way to do it, but still...
jellsprout
[?] Karma: 0 | Quote - Link
Saturday, October 31 2009, 5:43 pm EST
Lord of Sprout Tower

Karma: -2147482799
Posts: 6445
Gender: Male
pm | email
You can do the exact same at the Forum index.


Spoiler:
canadianstickdeath
[?] Karma: 0 | Quote - Link
Saturday, October 31 2009, 6:15 pm EST

Age: 35
Karma: 350
Posts: 2990
Gender: Male
pm | email
But you have to scan through the whole page...

I agree with what you guys are saying the more topics button should do, but I don't agree that it should be removed if it doesn't....
rocket guy
[?] Karma: 0 | Quote - Link
Thursday, November 26 2009, 2:57 am EST

Age: 21
Karma: -34
Posts: 39
Gender: Male
pm | email
how long do you get banned for. i know it's less than 2 days


w00t
somebody told me bang jan was a noob
Sefro
[?] Karma: 0 | Quote - Link
Thursday, November 26 2009, 3:02 am EST

Karma: 313
Posts: 1136
Gender: Male
Location: Canada
pm | email
For failing the profanity check, I believe you get banned permanently, on the spot.
rocket guy
[?] Karma: 0 | Quote - Link
Thursday, November 26 2009, 3:20 am EST

Age: 21
Karma: -34
Posts: 39
Gender: Male
pm | email
what do you mean


w00t
somebody told me bang jan was a noob
canadianstickdeath
[?] Karma: 0 | Quote - Link
Thursday, November 26 2009, 3:25 am EST

Age: 35
Karma: 350
Posts: 2990
Gender: Male
pm | email
If the reason you failed the profanity check was because you pasted in an FR2 code into the uploader, I'd doubt that you'd actually get frozen, unless the code actually contains profanity. Profanity checks only look through your cave's titles, so, since FR2 codes are all on one line?, your entire cave is going to be one big title. It's probably picking up on your strange use of symbols, and thinking that that's profanity. I'd guess you wouldn't get frozen, because what you uploaded didn't actually contain profanity, right? I'm pretty sure that I read somewhere, that somebody personally checks to ensure that you actually broken the rules before freezing you. It's not a completely automated system. I bet though, that doing this repeatedly, would be a quick way to get on somebody's nerves, lol.

So... did you actually get frozen, and was it for pasting the FR2 code? If you were frozen, it's permanently, but if you pasted an FR2 code, you might have a chance to get your account back?
snowman
[?] Karma: 0 | Quote - Link
Thursday, November 26 2009, 8:42 am EST
I am a person.

Age: 25
Karma: 38
Posts: 1209
Gender: Male
Location: Singapore The Lil' Red Dot
pm | email
'canadianstickdeath' said:
If the reason you failed the profanity check was because you pasted in an FR2 code into the uploader, I'd doubt that you'd actually get frozen, unless the code actually contains profanity. Profanity checks only look through your cave's titles, so, since FR2 codes are all on one line?, your entire cave is going to be one big title. It's probably picking up on your strange use of symbols, and thinking that that's profanity. I'd guess you wouldn't get frozen, because what you uploaded didn't actually contain profanity, right? I'm pretty sure that I read somewhere, that somebody personally checks to ensure that you actually broken the rules before freezing you. It's not a completely automated system. I bet though, that doing this repeatedly, would be a quick way to get on somebody's nerves, lol.

So... did you actually get frozen, and was it for pasting the FR2 code? If you were frozen, it's permanently, but if you pasted an FR2 code, you might have a chance to get your account back?


...by telling Neo that you posted the wrong code into the uploader.






Bang Jan
[?] Karma: 0 | Quote - Link
Thursday, December 31 2009, 10:29 am EST

Age: 24
Karma: -37
Posts: 641
Gender: Male
pm | email
i think no map name provided has been removed
Silver
[?] Karma: 0 | Quote - Link
Thursday, December 31 2009, 5:04 pm EST

Karma: 121
Posts: 3581
Gender: Female
pm | email
No it hasn't. TNT's far too fat and lazy to fix that.
Teo
[?] Karma: 0 | Quote - Link
Thursday, December 31 2009, 5:10 pm EST

Age: 25
Karma: 138
Posts: 1766
Gender: Male
Location: Warsaw, Poland
pm | email
And, from the 2008 year I really wanna know why TNT made the error " Please use only letters, numbers... ". Why? With the spaces was ok! so why there made it?
Silver
[?] Karma: 0 | Quote - Link
Friday, January 1 2010, 4:18 pm EST

Karma: 121
Posts: 3581
Gender: Female
pm | email
You better ask Jell, CSD or Livio, cos' I don't have a damn idea.

« Forum Index < The Hannah and the Pirate Caves Board
«Previous | 1, 2 | Next»

In order to post in the forums, you must be logged into your account.
Click here to login.

© 2024 The Interguild | About & Links | Contact: livio@interguild.org
All games copyrighted to their respective owners.