Database

What acopa.db is#

Everything you make in Roller — all your worlds with their stories, characters, places and games, the Protocol and the Patcher — is kept in a single file: acopa.db, in the Acopa folder (next to acopa.command). Mipsy keeps its story tree in the same file. It's locked with your password, so nobody can read it without it (Mipsy's Public stories excepted, which are not locked).

Acopa creates this file the first time it starts. A roller.db from Roller can be used as acopa.db (rename it, with Acopa not running): it opens with its old password. You never need to open it yourself.

Don't overwrite or share acopa.db#

• To share a world or story with someone, don't send them your acopa.db (they couldn't open it without your password anyway). Use Export legacy instead: it saves one world as a file they can import into their own Roller. See Export a world.
• To keep a backup of a world, export it the same way. You can also copy acopa.db somewhere safe while Acopa isn't running; that copy only works with your password.
• To move everything to another Mac, export each world there and import it on the other Mac: see Move a world to another Mac, or share it.

"acopa.db is for a different version of this app"#

When Roller starts, it checks that acopa.db was made by this version of the app. If it wasn't — for example because it comes from another version of Roller, or someone gave it to you — Roller doesn't touch it, and tells you so in a message.

1. Quit Acopa (close its Terminal window).
2. Move the file acopa.db out of the Acopa folder, for example to your Desktop. (Don't delete it if it might hold something you need.)
3. Start Acopa again. It creates a new, empty acopa.db and asks you to choose a password.

If someone gave you that acopa.db because they wanted to share a world or story with you, ask them to use Export legacy instead and send you the file it makes. You can then load it into your own acopa.db with Import world: see Import a world.