Skip to content

Update FAQ: Fix broken links, update ISO integrity instructions, cleanup for clarity#21

Open
deltaryz wants to merge 9 commits intoProject-Plus-Development-Team:masterfrom
deltaryz:master
Open

Update FAQ: Fix broken links, update ISO integrity instructions, cleanup for clarity#21
deltaryz wants to merge 9 commits intoProject-Plus-Development-Team:masterfrom
deltaryz:master

Conversation

@deltaryz
Copy link
Copy Markdown

@deltaryz deltaryz commented Mar 17, 2026

These instructions are outdated and no longer represent the current menu layout of Dolphin (neither mainline nor Project+ fork).

Many links were broken and led to a broken page, and there were some minor formatting inconsistencies and missing dividers

@deltaryz deltaryz changed the title Update FAQ: Brawl ISO integrity instructions + include missing link for mac GC USB adapter Update FAQ: Fix broken links, update ISO integrity instructions, cleanup for clarity Mar 17, 2026
Copy link
Copy Markdown
Contributor

@FunctionDJ FunctionDJ left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

see comments. also please run the formatter.

<hr />
<section>
<HA2 id="os-support">
Can I run Project+ on Windows/Mac/Linux/Steam Deck?
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i guess steam deck support is kind of correct with the linux build, but i don't think it's as easy as win/mac and regular desktop linux distros, so i'm hesitant to mention steam deck.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would you like me to write a dedicated steam deck section? I have a steam deck myself so I can make sure it's correct & works for a fresh install.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

not in this PR. you're welcome to open a separate PR for that after this one is merged.

Comment on lines +49 to +50
Unfortunately, Project+ does not have matchmaking like Slippi. Most
matchmaking happens through <a href="https://discord.gg/vdssRDg">Discord.</a>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

since the P+ discord is mostly used by the north-american communities for matchmaking, i think we shouldn't add it's link to th "Discord" word here.

https://github.com/jlambert360/FPM-AppImage/releases
</a>
To play Project+ on PC with Dolphin (Netplay supported), see the{" "}
<a href="https://www.smashladder.com/guides/view/27jj/project-m/project-v2-netplay-guide">Dolphin Netplay Guide</a>.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

now THAT is an ancient guide...
let's not reference it anymore.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you have a specific recommendation for a newer guide, or should we just stick to the video on the download page?
(Personally I'd really prefer to have a text guide as well, but you're right that one is old)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

<hr />
<section>
<HA2 id="iso-compatible">How do I know my Brawl ISO is compatible?</HA2>
<img src="https://i.imgur.com/qNOMtx0.png"></img>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

resources should not be loaded from a third party and instead be in this repository.

i know there was an imgur link before with a screenshot, but that was also suboptimal.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Where should the image be placed in the repo? I did try doing that but I kept the imgur approach because I couldn't discern what the right place to put the asset would be

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

see app/knuckles/page.tsx (import images from "~image-indexes/knuckles";) and the generate-imgs script in package.json

Comment on lines +248 to 251
<li>52ce7160ced2505ad5e397477d0ea4fe</li>
<li>d8560b021835c9234c28be7ff9bcaaeb</li>
<li>5052e2e15f22772ab6ce4fd078221e96</li>
<li>52ce7160ced2505ad5e397477d0ea4fe</li>
<li>9f677c78eacb7e9b8617ab358082be32</li>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why change the order of the MD5s here..?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I honestly forget why I did that.

Related to this, something I considered was changing out MD5 for SHA1 since Dolphin doesn't check MD5 by default. However, I don't have 5 different matching brawl dumps, so I can't get the SHA1 equivalents for all of these.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

then we'll stick with md5

<li>1c4d6175e3cbb2614bd805d32aea7311</li>
</ul>
<p>
If your game is not working, and the hash isn't listed here, it is
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i think the "if your game is not working" bit needs to be kept, since that's the symptom players may experience if they have a bad dump.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In that case, let's be even more specific - "If Project+ is not working"
this covers things like vanilla brawl booting instead of project+, more clear than the nebulous "game"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

agreed

Click here for Smashladder's Controller Guide.
</a>
Click here
</a> for Smashladder's Controller Guide.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why this change?

Comment on lines 377 to 381
<hr />
<h4>Can I play Project+ on an M1 Mac (ARM)?</h4>
<HA2 id="m1-mac">Can I play Project+ on an M1 Mac (ARM)?</HA2>
<p>
We are planning to swap the base of our Dolphin build sometime in the
future to restore Mac compatibility. M1 and beyond Macs will not be
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

if it's a HA2 it should be wrapped in a section

<li>Check <code>Calculate</code> near the MD5 box at the bottom</li>
<li>Click the <code>Verify Integrity</code> button and wait for analysis to complete.</li>
</ul>
<p>Compatible <code>MD5</code> hashes may include:</p>
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why wrap md5 in code ?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants