Giter VIP home page Giter VIP logo

partyplanner64's Introduction

PartyPlanner64

Mario Party N64 board editor

PartyPlanner64 allows players to create and import customized boards into a Mario Party N64 ROM for playback in emulators or on real hardware.

Getting Started

PartyPlanner64 is web-based so installation is not needed. A running copy is hosted from this repository. Chrome and Firefox are the supported browsers for this project.

It is highly recommended to read this before creating a board. This documentation highlights some common mistakes made while using PartyPlanner64.

The wiki has additional information about the editor, as well as technical documentation on the game itself.

Limitations

A ROM is not required to create and edit boards with PartyPlanner64, however to play them you will need to open a Mario Party ROM file. Only the NTSC USA files are supported.

  • Mario Party (U).z64 ROM file (MD5 8BC2712139FBF0C56C8EA835802C52DC).
  • Mario Party 2 (U).z64 ROM file (MD5 04840612A35ECE222AFDB2DFBF926409).
  • Mario Party 3 (U).z64 ROM file (MD5 76A8BBC81BC2060EC99C9645867237CC).

ROMs that have been edited can also be re-opened.

ROM files must be ran with Expansion Pak on hardware, emulators must be configured to use 8MB RAM or the game will crash.

Emulators

These emulators are reported to work:

  • Project64 2.3
  • Mupen64plus
  • Nemu64

This emulator has issues, even with the right setup (8MB RAM):

  • Project64 1.6

See the emulator setup page for details on configuring each emulator.

Building

To host a local copy of PartyPlanner64 clone the repository and do the following.

  • Install Node.js and a package manager (npm).

  • Retrieve the dependencies for the editor and development.

    • npm install --dev
  • npm run start will build a development version and run a local web server.

  • npm run build will build a production version and copy it into build/.

CLI Builds

See the README.md under apps/cli.

Electron Builds

After setting up a local dev environment, run the following to create the various Electron builds.

npm run electron

Contributors

Pull requests and other contributions are greatly appreciated.

License

Code in this repository is released into the public domain, with the exception of included third party libraries with separate licenses.

partyplanner64's People

Contributors

endlessbeat2604 avatar magioc avatar onisatomimi-no-miko avatar partyplanner64 avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

partyplanner64's Issues

Enhancement - Mini Game Maker

I have always loved Mario Party since I was boy but I always wanted to add more mini games. When I saw SSBB add completely new fighters and stages I cried because I have seen possibility but I have yet to see a Mario Party Mini Game Creator. I have also yet to see my favorite mario party game 7 be a modable thing at all. Anyways this is more of thoughts then and actual request. Thanks for reading.

Support Undo/Redo

Portions of the editor could support undo/redo, particularly interactions like placing spaces or paths.

It would be interesting to try something like Redux for state management to add a feature like this.

Star spaces turning into chance time spaces after star is purchased

I've finished my map and when I tested it, I found that once I buy a star and the next star in the rotation is up, the space that the first star was on was then a chance time space, when in the editor I had it as a plain blue space. This happened after I bought each star for some unknown reason.

Takes long to overwrite ROM

I have been sitting at my PC for about an hour now, and the loading screen with the moving pencil is still there after selecting a board to overwrite and beginning the loading process.

Is this a bug, or something it should usually do?

rom won't load

okay so I made a board, and it didn't have any errors on it. (red nor yellow), I used an american rom, replaced western land, and exported the rom. But it won't load at all, it's just a black screen. I tried Project 64 2.3, project 64 1.6, and 1964.

Decorative Star space missing from website?

Was using the editor earlier in the day and had access to the decorative star space which I was using for a project, but not it's not a selectable space type? Did this addition get chopped? Thanks for reading!

capture
capture2
capture3

Enhancement - More variety of happening spaces events

Firstly, I would like to voice my thanks to all who have been working in this project. However, I believe there is a crippling lack of a variety in what happening spaces can do. I understand that it is a complicated issue, but happening spaces are part of what made Mario Party and its sequels' boards special and distinctive from one another. As such, it would be good to be able to use them for more than for the happening space star and game variety, but at least to warp players around?

MP3 - Soft hang with low number of spaces

When overwriting Chilly Waters, if the number of blue/red spaces is too low, the game will hang just before the first players turn.

After some investigation, it seems to be that the game is looping endlessly trying to find a certain number of blue and/or red spaces. If the count is too low, it never finishes and hangs.

Temporary workaround is that MP3 validation will fail if the number of blue spaces is less than 14 and there is not a single red space. These are just semi-random limits that seem to work.

Add "Patches" view for applying Gameshark patches

When a ROM is loaded, it would nice to have way to easily patch the ROM with various patches. Off the top of my head, these are some that might be useful:

  • Patch to unlock all the boards for a particular game without having to earn all stars
  • Patch to unlock Daisy/Waluigi
  • Patch for that tank Mini-Game in MP2 to have 4 lives

Any other thoughts?

Support colors in rich text string editor

The string editor should be able to support the different font colors available in the games.

The editor is based on Draft.js, so it certainly has the potential to do this.

MP3: Poison Mushroom Broken

Using a Poison Mushroom on someone else doesn't work. The item appears to float around their head, but it does not change the dice block.

If you attempt to use another one (or maybe this is if you use it on yourself), the dice block does change, but the path breaks and you end up back at start before eventually crashing the game, just like the Reverse Mushroom. #21

Spaces moving considerably after patching ROM

This is a consistent issue I've been having: I finish my space layout and click to patch the ROM. I then load up this new ROM and see if it patched correctly. When I look at my newly replaced board, I find that all spaces in approximately the top third of the board have been pushed down considerably. I then proceeded to combat this by moving the effected spaces up before patching a new ROM. I then test out THIS ROM in game, only to find that the spaces have been pushed downward and toward the edges of the screen depending on the side that they're closed to a CONSIDERABLY large distance. Please help.

MP2: White screen when starting Hexagon Heat Mini-Game

Was play-testing a board in Mario Party 2 when the game soft-locked while loading Hexagon Heat, similar to the Tipsy Tourney crash as previously reported. I was using an emulator with the correct settings so I can only guess that it's an issue within the patched ROM.

Add more board themes

There is somewhat of a framework present for supporting "board themes" or, in other words, default assets that a board can start out with.

To add a theme, create a subfolder within the themes directory and include images that are named the same as the ones in the default theme folder. Then update newboard.jsx to recognize the theme.

I am not an artist so I will gladly accept reasonable themes to be included.

Support overwriting strings in languages other than English

Some ROMs include multiple string filesystems for different languages. PP64 is only writing to the English language listing.

There should be a way to create a board for any language, or rather, be able to add strings for multiple languages to a board file.

Can't get past splash screen.

Hey, I just made a new board for my group of friends on netplay, and when we tried to play the rom, it did the splashes on the splash screen fine, but after that it just went black. If you need I can post the board.

CPU players are super dumb

They only go the same way all the time. in some cases its impossible to lose because they don't go to the star.I know this isn't partyplanners fault but can you guys maybe do some thing to fix this.

MP2: White screen when starting Tipsy Tourney Mini-Game

Encountered a white screen hang when loading the Tipsy Tourney Mini-Game while running on the N64. Unconfirmed if this is an issue on emulators, or if it consistently happens.

One thought is that it might be a missing HVQFS patch, or that there is an HVQ patch that shouldn't use the signed addition workaround.

Saving in MP3 does not work

User reported:
After turning of the game and the opening it again, save file doesn't work.

Need to confirm if this works on real hardware. If so, probably a bad emulator assumption.

MP3: Movement in reverse breaks at branching points

Moving in reverse requires building out different space events that trigger when the player is moving backwards. Without these, memory values for the next chain / space become corrupt and the player path becomes unpredicable, leaning to crashing / hanging.

Support custom audio

Right now, PartyPlanner64 just treats the ROM audio section as one large binary chunk, and the only concern it has is that pointers to it are updated when packing the ROM.

PartyPlanner64 should initially be able to understand the audio section a bit more. It definitely has some sort of structure that could be parsed more finely.

Long term goal is to support custom audio tracks for boards.

Avoid losing in-progress work

PP64 tries to save the board list into localstorage when the window closes. In most browsers, this is a limited resource, and if the board data grows to large, the write fails and work is lost.

Ideally there would at least be one of those prompts "you have unsaved work, etc." that would appear. I couldn't get it to work initially.

The workaround is to export anything important before closing the window.

Support duel maps from MP3

The duel boards are mostly the same as real boards, but the space type integers are mapped differently. But aside from that and different event ASM, it should be pretty straightforward to support duel boards if there was effort put in to do so.

Skeleton Key Gate Intersection issues

Hi there, ran into a weird issue while messing around with PartyPlanner64. When you approach a gate without a Skeleton Key, it rejects you and you start working backwards like normal. If you reach an intersection without any followable paths, the character makes a mad dash back to the start and gets stuck.

Here's a quick example of a design that would get stuck, and how to fix it. This isn't really a bug in the program, but definitely something I would add to the gate requirements in the usage tutorial or have PartyPlanner64 warn you.

capture
capture2

MP3: Game crashes right before map is started

This is specifically happening on an Everdrive and I haven't been able to reproduce it on emulator.
I have been able to play other boards that others have created for MP3, but I'm not sure what is keeping this map from starting.
I had fixed all of the overwrite rom errors and issues before writing and saving the rom. The only thing that I can think of is if there is a limit to the filesize of the images. I was using this more as an experiment to play with the PP64 tool and learn the ins and outs so I didn't optimize any of the images to match resolutions or anything, but it did seem that the tool resized everything for me.

Update: Resized all the images, and it still just gets stuck on a black screen. It happens right after you go to hit the dice block to see who goes first.

Update 2: I was able to get the game to load fully on the everdrive by changing these star sections. We had finished with our board layout before seeing the 8 star minimum requirement for Chilly Waters and this was our "fix" so we didn't have to put more star spaces through out the map. Removing these areas so it is only a one path, one star intersection fixed it. Not sure if you could provide information on why what I had was illegal for actual hardware.
untitled

image

Koopa Troopa Beach.txt

Large screen background removed when overwriting ? ( MP2 )

#I feel like I did everything I should but for some reason, the large screen background is gone after overwriting the western land map. I made sure it was 320 x 240 but it still doesn't work. I can't launch the rom because of that.

I'm using Project 64 BTW. Here are the files if it can helps :

http://www.mediafire.com/file/1sxj627r6w8s751/mp2-files.zip
http://www.mediafire.com/file/8u9vwf0dg11g15h/Mad_Monster_Mansion%281%29.json

I tried changing the large screen background and the problem is still here.

Thank you in advance for looking into it.

Ability to interact with multiple spaces at once

The renderer should be able to support selecting multiple spaces at once.

  • Should be able to move multiple spaces at once.
  • Ideally be able to change the type/subtype of multiple spaces at once.
  • Holding ctrl and clicking should also work.

Computer AI do not understand custom boards

The AI tend to just always follow the same path for a given star location. There must be some place where the AI decisions are hard coded. The editor should be able to modify this hard coded data to reflect the new board layout.

Temporary workaround: play with friends, or enjoy beating the computer AI.

Can't Open Rom With Overwritten Board

Hey PartyPlanner64. I spent last evening creating a board that I was really excited about to share with my friends, but when I was done, I was running into issues with actually playing it. The newly created ROM didn't seem to play with any version of Project 64 I owned. The program did allow me to overwrite DK's Jungle Adventure with my board, to the point where it wouldn't give me any warnings or errors. And if I imported the board back into PP64, it would import properly and show that the overwrite was successful and everything.

Clearly there is probably something "iffy" about the board in question, whether it's too big (or the wrong size in general) or the fact that there might be too much going on, but because I don't know the reason, I'm at a huge loss on what to do next to try and get this to work, so I came here for some ideas.

Also, I've been trying to attach my board file to this post, but it's not letting me because json is not an appropriate file type. I also tried putting in a zip file to also no avail (even though it says ZIP files are acceptable....)

Spaces do not line up exactly how they are placed in the editor

PP64 is doing a crude conversion from the XY plane to the XYZ coordinates the game uses. It is somewhat accurate at the center of the board but things get off further out.

I had looked into what the game was doing at one point but I never figured out the exact formula. It appears the coordinates go through at least one conversion before probably getting pulled into some display list.

As a temporary workaround, you can compensate by shifting the spaces against whatever direction they are trending.

MP3: Characters

Dont know what happened, but daisy and waluigi are unusable now. the css opens and they are '?'

Create a "String Editor" view to edit all game strings

It would be nice to create an (advanced) feature to edit or view all strings in the ROM. This would help with more complex ROM hacks and also help make the string rich text editor more robust.

This could just be a paginated view of rich text editors with all the strings.

MP3: Game does not reset turn when saved and resumed

User reported:
"Quitting in the middle of a turn of MP3 and going back to the game will have you start before or at the start of that character's turn, not at the very start of the entire turn."

Very odd, need to see if this is expected behavior.

Iron out string format

The basics of the string format are understood, but in particular the differences in MP2 and MP3 are not well understood. See the wiki for what is currently known (and the strings.js and adapter files).

Event spaces disappearing after patching ROM

I placed an event space next to Boo and then patched the ROM. After I loaded up this ROM in PP64, I found that the event that was attached to the space was gone. I did use the space that is used for junctions (not sure what to call this space). This combined with other issues is making my board nearly impossible to create properly.

Custom Title Screen Support

This is obviously an enhancement, but I think support for custom title screen images would be pretty sweet.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.