-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Q: I have never owned a game on the supported platforms. Where do I start? A: Click the "+" button, tap on Repos, tap on the Homebrew repo under Featured Repos, and then it will be added as a repo. Tap it, and find a game you like. All of the listed ROMs (except Mother 3) should be fine to be used without legal concerns. Any other repos will require ownership of the original game.
Q: I want to suggest a feature or report a bug. How do I do so? A: Use the below link, read the attached README, and submit an issue on our GitHub issue tracker: https://github.com/iGBAEmu/EclipseIssues/
Q: I want to make a repo. Where do I start? A: The repo format is documented at the below link: https://gist.github.com/Shugabuga/64cea72c7853f6c610c765f1531eb85a
Q: I am an iGBA user who wants to upgrade to Eclipse without losing my game progress. How do I do so? A: To do this, go to iGBA, open Settings, then tap "Export State." This will either download a file (which can be uploaded during setup) or display text (which can be pasted during setup), which will port all of your ROMs, save states, and skins to Eclipse. Make sure you tap the option that says "Import Data from iGBA or Eclipse State..." to import your data during setup (it can be done later in Settings).
Q: I am having issues and need to do some self-debugging. How do I do so? A: Eclipse has a built-in debugger as of version 1.0.9. To make it visible, go to Settings and tap on the navbar (with the word "Settings") five (5) times to enable Debug Mode. Go into the debugger menu, and various options would be available (such as the ability to create an issue with all important information pre-attached, the states of various settings, and some buttons to force Eclipse to run certain tasks.
Q: How do I add custom ROMs? A: To do so, you need two things: album art and a direct link. The direct link would typically end in .gba, .gbc, .gb, and .nes and would not be from a service like Google Drive, MEGA, or MediaFire (we recommend Dropbox or your own server, as we do not officially provide support for anything other than it and standard web/file servers). Press "+" and tap on Manual. Put in the direct link and the album art as needed, and then add it. If you did everything alright, it should run as intended.
Q: What games are recommended? A: Look through your stuff and find a physical cartridge. If you have none, you are limited to homebrew games for legal reasons. Please don't pirate games when using Eclipse.
Q: This ROM (added from a link) isn't working. Why isn't it? A: A good test is to first download the ROM locally and upload it to Eclipse directly. To do this, press the "+" button and tap Upload. Select your ROM from your files, and load it with the corresponding button.
- If the game is not a Gameboy Advance game and doesn't load, the ROM is probably bad or doesn't work with Eclipse.
- If it is and it doesn't, wait for the splash screen (it can take some time).
- If you see the splash screen and the Nintendo branding is gone or corrupted, the ROM file is not supported by Eclipse.
- If it works perfectly when uploaded, your issue is probably a bad URL. Make sure the URL downloads the ROM when it is visited and doesn't display a download button. We recommend that you use Dropbox to store your ROMs, not sites like Google Drive, MediaFire, or MEGA (which are not officially supported)." Q: I made a repo or skin. How do I get it featured inside of Eclipse? A: Please contact an Eclipse developer (such as HeyItsShuga). Please note that no skins or repos that are not appropriate for children under twelve (12) would be featured, as well as repos that contain Nintendo-licensed games.
Q: I want iGBA back. How can I get it back? A: iGBA is depreciated, as Eclipse replaces it. Export your iGBA state (backup) and import it to Eclipse. Any iGBA features that weren't ported to Eclipse can be reported on our GitHub issue tracker (https://github.com/iGBAEmu/EclipseIssues, please read the README if you aren't familiar with GitHub) and should be brought over soon.
Q: Can I use iGBA repos with Eclipse, and if so, how? A: You cannot officially, but you can use @1GamerDev's shim to convert a repo to use Eclipse's new format, which makes links that can be used in Eclipse itself. The link to it is below: https://igbaemu.com/iGBARepoToEclipse.php
Q: I am uploading a ROM to Eclipse but it isn't saved to the main menu. Why? A: This is a technical limitation. iOS's MobileSafari (which is what many users use) limit localStorage space to ~50MB, while many games (especially GBA games) can use up to 35 MB (like Mother 3). This probably will not be changed, as other parts of Eclipse also use this space for offline usage.
Q: Does Eclipse work offline? A: Eclipse does work offline, but certain features (like repos and your game collection) will be disabled. To use a game offline, you need to upload it under "+."
Q: Are save states stored for uploaded ROMs? A: A game's save data should be restored when its file is re-uploaded.
Q: Is there formal documentation on features like skins, repos, and share URLs? A: Yes, and it can be found at https://eclipseemu.me/docs/.
Q: How does saving work in Eclipse, and what systems are supported? A: The systems that support saving are GBA, GBC, and GB. The NES does not support saving. Saving is done like it is on the original console: going into the game menus and using the save function. After using the in-game save function, tap Menu, then Save, then wait a few seconds for Eclipse to save your game progress to your device (thirty [30] seconds is safe enough).
Q: Eclipse is slow for me. Why is that? A: On devices worse than an iPhone 6s (or comparable), Eclipse will be slow, even if emulators like Delta or RetroArch work fine. Since Eclipse is Web-based and web browsers aren't as powerful as native applications or programs, performance hiccups are to be expected."
Q: What repos are recommended? Where can I find repos?
A: A comprehensive list of community-operated repos is available at https://magnetardev.github.io/eclipserepos/.
Please note that we don't encourage piracy, are not responsible the contents of any community repos, and will not add repos with an abundance of licensed ROMs as a featured repo in Eclipse.