jak-project/FAQ.md
ManDude 4a7a297649
write a FAQ page (#1186)
* Create FAQ.md

* Update FAQ.md

* Update FAQ.md

* Update README.md
2022-02-19 21:17:42 -05:00

5.7 KiB

How is this project possible?

Naughty Dog created a custom programming language called GOAL, along with a compiler for it. GOAL makes up 98% of all the code in Jak & Daxter, and the GOAL compiler does not have the same amount of optimizations as C or C++ compilers have, which means that the compiler often times left specific instructions that denote some specific kind of control flow, which lets us piece back the original structure of the code accurately for about 99% of the functions in the game. Nearly every type in GOAL also has an autogenerated debug inspect method, which prints all of a type's fields by default. These inspect methods can tell us what fields were in the type, at what offset, and what their type was.

How finished is the project?

We estimate it is about 75% done. Most of the renderers are finished and there is no sound.

When will the project be finished?

Hopefully just a few more months!

Why is there no sound?

We have not started work on sound at the moment.

Will you also decompile Jak II?

Likely yes!

Will you also decompile Jak X?

We don't know yet.

How can I run the game?

The project readme contains instructions on installing and running the game. You need to bring your own copy of the game, we provide none of its assets.

I am having trouble running the game!

Keep in mind the project is currently in development and is not adapted for end users at the moment. If you are having trouble, there are some extra troubleshooting steps at the bottom of this page. If the common issues do not include your specific issue, feel free to join the discord server and ask for help in the help channel.

Does the game have differences? I don't remember these options!

We have added a plethora of options to the game settings (and removed some that didn't make sense) so that you can have a more up to date experience, or a more PS2-like experience if you decide. It is up to you! There are also a bunch of extra goodies and added secrets to find out. We are aiming to keep the core gameplay (controls, physics, behaviors, etc.) identical however, so if you find any issues or differences with this then do not hesitate to tell us about it.

Where can I find a list of differences?

This page contains a list of ideas and suggestions we have for the game, but it does not cover all the deliberate changes we have made. We will probably compile a list at some point! In the meantime, feel free to ask us about this.

Will there be bug fixes to the game?

The original game had a few issues of varying severity - from progress softlocks to crashing - that we are aiming to patch. The complexity of these issues is varying (if they were simple to reproduce and fix, Naughty Dog likely would have done it), but so far we have fixed 2 issues that could crash the game.

Will there be mod support?

In the future yes! We intend to make it as easy as it can be to make your own code or import graphics for the game.

What is this menu? Why am I not dying sometimes?

This might be the result of the game beeing booted in debugging mode. The project is still in development and we rely on the game's built-in debug features (along with some we made ourselves) for testing and development. The final product will have this debug mode disabled. In the meantime, have fun with all the options! Keep in mind some don't work very well.

What are the minimum requirements?

These are not totally set in stone as the project is not complete. These are the minimum architecture requirements for the project:

  • x86-64 CPU with AVX support. Most, if not all, 64-bit CPUs should work. OpenGOAL has a very small CPU footprint, so most modern CPUs will run the game fine.
  • Graphics card that supports OpenGL 4.3. The rendering code is still very much in progress. NVIDIA graphics cards should have no issue running the game, but AMD cards might struggle unless you have a more powerful one.
  • You might experience slower loads with a hard drive compared to an SSD.

Will there be a Vulkan version of the game?

Probably yes, in the future!

I'd like to contribute, but don't know where to start!

Great to hear! Any help is good help. If you haven't already, please read the project readme. It has information on what is done, what isn't done, what is being worked on, the project layout and how it all works. Then just join our development discord server and we can help you further.

Will you also decompile other games that aren't Jak?

No.

Yes.

Troubleshooting

None of the tools are working!

Because of its in-development state, we provide no pre-built binaries at the moment. The project readme has instructions on how to compile the tools.

I am getting "illegal operation"/"illegal instruction" errors when running the game or tools.

This shouldn't happen, so please contact us in the support channel of the discord server and we can help, and tell us if your CPU supports AVX, AVX2 or AVX512.

The game is really slow.

Your GPU is probably too weak and our renderers too slow. However, we plan on making significant changes to the renderers over time to improve performance. The merc renderer right now is very slow, if you would like to turn off then head to the debug menu by pressing R3, then go to Render... and turn merc off.

The game crashed!!

Crap! Contact us in the help channel on the discord server and tell us about it! Post the log files as well. These are located in the log folder of the project.

The game crashed when entering the final boss area!

This one specifically is known. We are investigating this at the moment, so don't worry.