Homes: Difference between revisions

From Resonite Wiki
Add more ways of opening the group world URL
No edit summary
 
(17 intermediate revisions by 3 users not shown)
Line 1: Line 1:
When you start Resonite by default, you'll open two worlds referred to as homes:
<languages/>
* Cloud Home
* Local Home


In addition if you are part of a group, you'll have access to a Group Home.
<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>


== Cloud Home ==
<translate><!--T:4--> In addition if you are part of a group, you'll have access to a Group Home.</translate>
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.<br>
== <translate><!--T:5--> Cloud Home</translate> ==
Technically, this world is same as normal world. If want not to load Cloud Home, use this argument: <code>-DoNotAutoLoadHome</code>
<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>


== Local Home ==
<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>
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.
<translate>By default, you will load into the [[Resonite Cloud Home|Cloud Home template]] provided and maintained by the [[Resonite Team]].</translate>


=== Using the Local Home for storage ===
<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>
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''':
<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>
* 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 ===
== <translate><!--T:9--> Local Home</translate> ==
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><!--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>


== Group Home ==
<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>


: '''''Help needed: this section needs more information!'''''
=== <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>


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><!--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>


In theory, opening the URL <code>resrec:///<group ID>/R-Home</code> using [[ProtoFlux]], or editing an existing world orb, or pasting the URL into Resonite using Ctrl+V would create a group home from a template.
=== <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>


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.
=== <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>


== Saving homes ==
=== <translate><!--T:36--> Alternative ways of focusing into the Local Home</translate> ===
'''All of your Homes''', will save when:
<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). -->
* You manually save your them, in the session menu using "Save Changes"
* You exit Resonite using the "Exit and Save Homes" button in the Exit Menu


[[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
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.
The exit screen, with the "Save Changes" option highlighted.