add mention of the GitHub issue |
WhiteBeardy (talk | contribs) No edit summary |
||
(16 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> | |||
<translate><!--T:1--> When you start [[Resonite]] by default, you'll open two [[World|worlds]] referred to as homes:</translate> | |||
* <translate><!--T:2--> [[Resonite Cloud Home|Cloud Home]]</translate> | |||
* <translate><!--T:3--> [[Local Home]]</translate> | |||
<translate><!--T:4--> In addition if you are part of a group, you'll have access to a Group Home.</translate> | |||
== <translate><!--T:5--> Cloud Home</translate> == | |||
<translate><!--T:6--> Your Cloud Home, is your "home" in Resonite. You'll load into it by default once you're logged in. Feel free to customize it to your liking with items, furniture etc that you find around Resonite.</translate> | |||
<translate><!--T:7--> The Cloud Home, is synced to the Resonite Cloud and will be available on any computer you log into your Resonite account with.</translate> | |||
<translate>By default, you will load into the [[Resonite Cloud Home|Cloud Home template]] provided and maintained by the [[Resonite Team]].</translate> | |||
<translate><!--T:8--> Technically, this world is the same as a normal world, this means you can set your Cloud Home to any world you have saved in your [[Inventory|Inventory]], by selecting the world orb and clicking the "Set Home" button.</translate> | |||
<translate>If you do not want to load the Cloud Home, you can go to [[Settings]] inside the "Profile" tab and toggling the "Load cloud home on startup", or use this argument: <code>-DoNotAutoLoadHome</code></translate> | |||
== | == <translate><!--T:9--> Local Home</translate> == | ||
<translate><!--T:10--> Your [[Local Home]], is a home that is confined to your computer. You can save things in there(including worlds), and they'll only be saved to your computer. If you login to Resonite from another computer, your Local Home's contents will not be there.</translate> | |||
<translate><!--T:11--> As it is not synced, items(and worlds) saved there are not as safe as items saved in the Cloud Home or Cloud Inventory etc. Please make sure you're backing up anything saved there that you might not want to lose.</translate> | |||
: '''' | === <translate><!--T:12--> Using the Local Home for storage</translate> === | ||
<translate><!--T:13--> Many people advise you not to save stuff to your Local Home or not to use it. That's not really correct though, '''if you understand the limitations of the Local Home, it is perfectly acceptable to save stuff there'''.</translate> | |||
<translate><!--T:14--> For example, your Local Home '''will be cleared or lost if''':</translate> | |||
* <translate><!--T:15--> You delete your local database - You shouldn't be doing this that often.</translate> | |||
* <translate><!--T:16--> You lose access to your computer.</translate> | |||
* <translate><!--T:17--> The hard drive, used for your local database is lost, corrupt or damaged.</translate> | |||
* <translate><!--T:18--> You re-install your operating system.</translate> | |||
* <translate><!--T:19--> Your local database is corrupted.</translate> | |||
=== <translate><!--T:20--> Creating Avatars in your Local Home</translate> === | |||
<translate><!--T:21--> If you're making an avatar using the avatar creator in your local home, then the avatar cannot have the "Protect Avatar" option checked on. This is because in your Local Home, you are not logged in and have no user. Therefore the protection systems for avatars are not available in your Local Home. If you want to create a protected avatar, make it in your Cloud Home, or another world.</translate> | |||
=== <translate><!--T:33--> Submitting a world in your local home</translate> === | |||
<translate><!--T:34--> If your trying to [[Submitting Worlds|submit a world]] while in your local home, it will not work as the World Publisher will just not do anything and get stuck on "Publishing...".</translate> | |||
<translate><!--T:35--> This is due to you not being logged in and Resonite cant read your User ID. If you want to submit a world, do it in the cloud home or in another world.</translate> | |||
== | === <translate><!--T:36--> Alternative ways of focusing into the Local Home</translate> === | ||
<translate><!--T:37--> By using the [[ProtoFlux:Focus World|Focus World]] node, you can focus into your own local home by giving it the URL of your home. Using the URL <code>resrec:///M-<Machine ID>/R-Home</code> for that node and calling it will take you there.</translate> <!-- (TODO: Figure out why some users are unable to use this alternative method). --> | |||
[[File:Resonite Exit.png|left|thumb|609x609px|The exit screen, with the "Save Changes" option highlighted.|alt=Purple text saying "Exit Resonite" with two buttons. "Exit & Save Homes" with a blue circle and green floppy disk icon on the left being highlited and "Exit & Discard Homes" with a red circle and X mark icon on the right.]] | == <translate><!--T:22--> Group Home</translate> == | ||
: <translate><!--T:23--> '''''Help needed: this section needs more information!'''''</translate> | |||
<translate><!--T:24--> Resonite has a [[Group]] system, if you are a member of any Groups, you'll also have access to a Group Home. The group home can be edited and opened by any member of the group.</translate> | |||
<translate><!--T:25--> In theory, opening the URL <code>resrec:///<group ID>/R-Home</code> using [[ProtoFlux]], editing an existing [[WorldOrb|world orb]] or pasting the URL into Resonite using Ctrl+V would create a group home from a template.</translate> | |||
<translate><!--T:26--> This method is currently not working and displays the following line in the logs <code>Creating a new Group Home from the template URL: resrec:///G-Resonite/Worlds/HomeTemplates/Group</code> to then fail. Issue [https://github.com/Yellow-Dog-Man/Resonite-Issues/issues/1144 #1144] on GitHub has been created to hopefully resolve this issue.</translate> | |||
== <translate><!--T:27--> Saving homes</translate> == | |||
<translate><!--T:28--> '''All of your Homes''', will save when:</translate> | |||
* <translate><!--T:29--> You manually save them, in the session menu using "Save Changes"</translate> | |||
* <translate><!--T:30--> | |||
You exit Resonite using the "Exit and Save Homes" button in the Exit Menu | |||
</translate> | |||
[[File:Resonite Exit.png|left|thumb|609x609px|<translate><!--T:31--> The exit screen, with the "Save Changes" option highlighted.</translate>|alt=<translate><!--T:32--> Purple text saying "Exit Resonite" with two buttons. "Exit & Save Homes" with a blue circle and green floppy disk icon on the left being highlited and "Exit & Discard Homes" with a red circle and X mark icon on the right.</translate>]] |
Latest revision as of 09:03, 18 June 2024
When you start Resonite by default, you'll open two worlds referred to as homes:
In addition if you are part of a group, you'll have access to a Group Home.
Cloud Home
Your Cloud Home, is your "home" in Resonite. You'll load into it by default once you're logged in. Feel free to customize it to your liking with items, furniture etc that you find around Resonite.
The Cloud Home, is synced to the Resonite Cloud and will be available on any computer you log into your Resonite account with.
By default, you will load into the Cloud Home template provided and maintained by the Resonite Team.
Technically, this world is the same as a normal world, this means you can set your Cloud Home to any world you have saved in your Inventory, by selecting the world orb and clicking the "Set Home" button.
If you do not want to load the Cloud Home, you can go to Settings inside the "Profile" tab and toggling the "Load cloud home on startup", or use this argument: -DoNotAutoLoadHome
Local Home
Your Local Home, is a home that is confined to your computer. You can save things in there(including worlds), and they'll only be saved to your computer. If you login to Resonite from another computer, your Local Home's contents will not be there.
As it is not synced, items(and worlds) saved there are not as safe as items saved in the Cloud Home or Cloud Inventory etc. Please make sure you're backing up anything saved there that you might not want to lose.
Using the Local Home for storage
Many people advise you not to save stuff to your Local Home or not to use it. That's not really correct though, if you understand the limitations of the Local Home, it is perfectly acceptable to save stuff there.
For example, your Local Home will be cleared or lost if:
- You delete your local database - You shouldn't be doing this that often.
- You lose access to your computer.
- The hard drive, used for your local database is lost, corrupt or damaged.
- You re-install your operating system.
- Your local database is corrupted.
Creating Avatars in your Local Home
If you're making an avatar using the avatar creator in your local home, then the avatar cannot have the "Protect Avatar" option checked on. This is because in your Local Home, you are not logged in and have no user. Therefore the protection systems for avatars are not available in your Local Home. If you want to create a protected avatar, make it in your Cloud Home, or another world.
Submitting a world in your local home
If your trying to submit a world while in your local home, it will not work as the World Publisher will just not do anything and get stuck on "Publishing...". This is due to you not being logged in and Resonite cant read your User ID. If you want to submit a world, do it in the cloud home or in another world.
Alternative ways of focusing into the Local Home
By using the Focus World node, you can focus into your own local home by giving it the URL of your home. Using the URL resrec:///M-<Machine ID>/R-Home
for that node and calling it will take you there.
Group Home
- Help needed: this section needs more information!
Resonite has a Group system, if you are a member of any Groups, you'll also have access to a Group Home. The group home can be edited and opened by any member of the group.
In theory, opening the URL resrec:///<group ID>/R-Home
using ProtoFlux, editing an existing world orb or pasting the URL into Resonite using Ctrl+V would create a group home from a template.
This method is currently not working and displays the following line in the logs Creating a new Group Home from the template URL: resrec:///G-Resonite/Worlds/HomeTemplates/Group
to then fail. Issue #1144 on GitHub has been created to hopefully resolve this issue.
Saving homes
All of your Homes, will save when:
- You manually save them, in the session menu using "Save Changes"
- You exit Resonite using the "Exit and Save Homes" button in the Exit Menu