Homes: Difference between revisions

From Resonite Wiki
Marked this version for translation
Major edits to Local Home section to improve readability, tone, and reduce redundancy.
Line 19: Line 19:


== <translate><!--T:9--> Local Home</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>Your [[Local Home]] is a built-in world which is not connected to the Resonite cloud. It is stored <strong>only</strong> on your local machine.</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>Any item, including worlds, may be stored there. These stored items will only be available locally; if you log in to Resonite from another machine, your Local Home's contents will be unavailable.</translate>
 
{{Note|<translate><!--T:13--> Many people advise you not to save stuff to your Local Home or not to use it. If, however, you understand the limitations of the Local Home, <strong>it is perfectly acceptable - and a valuable tool - for saving work and content</strong>.</translate>|warning}}


=== <translate><!--T:12--> Using the Local Home for storage</translate> ===
<translate>As it is not synced, compared to items saved in synced areas (Your Cloud Home, Cloud Inventory, etc.), items and worlds saved in your Local Home may risk data loss in the following situations:</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. [[Clear_your_Cache#Regularly_doing_this?|You shouldn't be doing this often.]]</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: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: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:18--> You re-install your operating system.</translate>
* <translate><!--T:19--> Your local database is corrupted.</translate>
* <translate><!--T:19--> Your local database is corrupted.</translate>
<translate>Please ensure any work here that you might not want to lose has been backed up elsewhere.</translate>


=== <translate><!--T:20--> Creating Avatars in your Local Home</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:21--> While in the Local Home, you will not be logged into the Resonite platform, and your user account will not be available.
 
As a result of this, when using the [[Avatar_creation#Avatar Creator|avatar creator]] in your Local Home, the "Protect Avatar" option cannot be selected. This is as the protection systems for avatars require access to your user account.  
 
If you wish to create a protected avatar, please create it in a cloud synced world (such as your Cloud Home).</translate>


=== <translate><!--T:33--> Submitting a world in your local home</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:34--> All [[Submitting Worlds|world submissions]] while in your Local Home will remain stuck on a <strong>Publishing...</strong> status. This is a result of the above-mentioned user account limitations.</translate>
 
<translate><!--T:35--> If you wish to submit a world, please submit it in a cloud synced world (such as your Cloud Home).</translate>


=== <translate><!--T:36--> Alternative ways of focusing into the Local Home</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). -->
 
{{Note|<translate> This method is currently non-functional for some users. Investigation into this issue is ongoing.</translate>|warning}}<!-- (TODO: Figure out why some users are unable to use this alternative method). -->
 
<translate><!--T:37--> By using the URL <code>resrec:///M-<Machine ID>/R-Home</code> on the [[ProtoFlux:Focus World|Focus World]] node, then calling said node, you can focus into your own Local Home.</translate>  


== <translate><!--T:22--> Group Home</translate> ==
== <translate><!--T:22--> Group Home</translate> ==

Revision as of 01:21, 8 August 2025

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 built-in world which is not connected to the Resonite cloud. It is stored only on your local machine.

Using the Local Home for storage

Any item, including worlds, may be stored there. These stored items will only be available locally; if you log in to Resonite from another machine, your Local Home's contents will be unavailable.

Many people advise you not to save stuff to your Local Home or not to use it. If, however, you understand the limitations of the Local Home, it is perfectly acceptable - and a valuable tool - for saving work and content.

As it is not synced, compared to items saved in synced areas (Your Cloud Home, Cloud Inventory, etc.), items and worlds saved in your Local Home may risk data loss in the following situations:

  • You delete your local database. You shouldn't be doing this 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.

Please ensure any work here that you might not want to lose has been backed up elsewhere.

Creating Avatars in your Local Home

While in the Local Home, you will not be logged into the Resonite platform, and your user account will not be available.

As a result of this, when using the avatar creator in your Local Home, the "Protect Avatar" option cannot be selected. This is as the protection systems for avatars require access to your user account.

If you wish to create a protected avatar, please create it in a cloud synced world (such as your Cloud Home).

Submitting a world in your local home

All world submissions while in your Local Home will remain stuck on a Publishing... status. This is a result of the above-mentioned user account limitations.

If you wish to submit a world, please submit it in a cloud synced world (such as your Cloud Home).

Alternative ways of focusing into the Local Home

This method is currently non-functional for some users. Investigation into this issue is ongoing.

By using the URL resrec:///M-<Machine ID>/R-Home on the Focus World node, then calling said node, you can focus into your own Local Home.

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.