wiki.sine.space | sinespace

Difference between revisions of "Regions"

From wiki.sine.space
Jump to: navigation, search
(Region - Platform Settings)
 
(41 intermediate revisions by 5 users not shown)
Line 1: Line 1:
Create and upload a region
+
<div style="margin:0 auto; vertical-align: text-top;">
  
 +
<table style="border-radius: 4px; background-color: #FFFFFF; padding-left: 15px; padding-right: 15px; padding-bottom: 8px; padding-top: 12px;">
 +
<tr>
 +
<td>
 +
[[File:Howtocreateashopbanner.jpg]]
  
==[[Link Space and Unity]]==
 
  
[[Link Space and Unity]]
 
  
* Grab an API key from https://curator.sine.space/ and link it to your Unity project.
+
There are different ways to build regions in space.  
* Download and import the Space Editor Pack prefab into your Unity project.
+
  
==[[Basic Scene Set Up]]==
+
You can build region assets in other software packages and import into Unity.
  
[[Basic Scene Set Up]]
+
You can use Unity's mesh shapes and terrain tools, and you can grab third party assets from the Unity Asset Store.
  
* Assemble your scene content
+
All of the pages linked here all refer to the Scene Export Settings/Scene Save Settings component:
* Remove the main camera
+
* Add a landing zone
+
  
==[[Region - Virtual Good Settings]]==
 
  
[[Region - Virtual Good Settings]]
+
[[File:Scenesavesettings.jpg]]
  
* Add Scene Settings Component
 
* Fill in Virtual goods information
 
  
==[[Region - Export Settings]]==
+
If you want to upload a region quickly, click on 'File>New Sinespace Scene' in Unity to instantly create a quick-start region.
  
[[Region - Export Settings]]
 
  
* Choose whether your region is downloaded as one file or streamed progressively to your guests.
+
==Assemble your scene==
* Set your region's loading page
+
* Reserve your region's unique URL
+
  
==[[Region - Platform Settings]]==
+
You can upload any scene you create in Unity as a region in Space.
  
[[Region - Platform Settings]]
+
Once your scene is assembled you have two housekeeping tasks;
  
* Choose which platforms to publish your regions in.
 
* Fine tune the export settings for each platform.
 
  
==Submission Process==
+
==Remove Main Camera==
  
[[Submission process]]
+
When you create a new scene in Unity it will by default have a light and a camera.
  
REPORT
+
You need to delete the camera (by selecting it in the Hierarchy window and clicking delete).
  
Info
 
  
This shows how many objects, root objects and colliders your scene has. It will flag potential performance issues.
+
[[File:Camera.jpg]]
  
[[File:]]
 
  
Script list
 
  
Space currently has a white list of approximately 120 scripts you can deploy in your regions. The script list shows all the scripts in your project, flagging the ones not currently white listed, which will be stripped out when submitted.
+
==Add Landing Zone==
  
You can submit scripts to your account manager for inclusion in the white list. When the platform's SDK is released (scheduled for September 2016) the white list will be maintained in parallel.
+
You need to define where users arrive when they log in to your region; and what direction they are facing.  
 +
To do this, once your scene is set up, from the top menu in Unity select Game Object / Create Other / Landmark.
  
Apply compression settings
+
OR;
  
Click this button to apply the Platform Settings (above) to the assets in your scene.
+
If your Scene Heirarchy menu does not include Create other / Landmark, then;
  
Once the automated compression has run you can manually adjust individual files before publishing. You might, for instance, apply 512 as a maximum image size for the WebGL version of your region but then revert one or more specific important textures back to a higher resolution.
+
Create empty object, then in the Inspector, add "Landmark behaviour" component.
  
[[File:]]
+
This will place a new landmark item in your scene. In the Inspector window, set the type to Landing Zone and tick Spawn Point.
  
Sort into layers
+
The in scene object is a yellow edged transparent plane which you can position anywhere in your scene.
  
Click this button to automatically assign every asset in the scene to one of four draw distance layers, according to their size; larger objects are set to be visible at greater distances.
+
The yellow arrow points in the direction your visitors will face when they arrive.
  
The draw distance for each user is determined by the quality settings they select inworld;
+
Be careful to position the landing zone slightly above the terrain; if a tall avatar's feet arrive below the terrain they may fall through.
  
[[File:]]
 
  
Default = 20 to 75m
+
[[File:Landmark.jpg]]
Important = 80 to 320m
+
VImportant = 240m to 900m
+
NotImport = Max 30m (60m in Beautiful/Ultra)
+
NotImportLandmark = Max 60m (120m in Beautiful/Ultra)
+
  
If you do not apply Sort into layers button everything will be left in default layer.  
+
==Adding a New Scene to your Region==
 +
<b>This does not apply if you are using Multi-Scene Mode & Multi-Scene Editing.</b><br>
  
After applying you can manually review and modify;
+
You can have more then one scene in your region.<br>
 +
1 - Create a new scene in your current Sine.Spaces project.<br>
 +
2 - Double click the new scene in your Assets to load it into the Hierarchy.<br>
 +
2 - Design your scene. Be sure to save it.<br>
 +
3 - When ready to upload to the server click on 'Space' Scene Settings.<br>
 +
4 - Fill out the needed information, map pictures, and click Automatic Submission.<br>
 +
To teleport between one scene to another see [[https://wiki.sine.space/index.php?title=Components/TeleportWorld Teleport World]]
  
[[File:]]
+
==Create a Home Region/Template==
 +
If you want to make your region as a home type, which could be edited by the users themselves, you need to attach a component which is called "Room Floor" to one of the item in the scene, usually the terrain or the object used as a field. With at least one room floor component, the region will show "Edit Room" button when you in it. You can add several Room Floor components to different objects, each floor can be shared to another user, gives him/her the authority to edit.<br>
 +
In your inventory, you will also find an item with same name of the region. This is a home template. You can use it in "Edit Room" -> "Design" function, to change the whole set of a region. Of course you could set a price for it when upload, so other user can buy it in the shop. <br>
  
Automatic submission
+
Please see our [[Room_Floor_System|Room Floor]] page for more information on the Room Floor component.
  
Once your scene is ready to submit, click Automatic submission. This will create a zip file containing the region and will send it to the Space servers.
+
<b>Please pay attention that ALL the room edit info, like where you put some furniture is recorded in this "Room Floor" script. When you update your region, try not to remove this component in whatever situation. If you remove an old one then attach a new one to another object, the region update will cause all the users who are using your region template to find their region has gotten reset. If you must do that, try to let users of your template know this and be prepared for the overhaul updates.</b>
  
Here the assets will be unpacked and compiled for each of the different platforms you have specified. You will receive three automated emails; confirming the content has been received, has started processing and has been released for you to log in and review.
+
If you want to add a day/night cycle to your home region/template, please do see our [[Day/night_cycles|Day/Night Cycle]] page for more information.
  
==Region Management==
+
==Region Tutorials==
  
[[Region Management]]
+
After placing your landmark, go to 'Sinespace' at the top of Unity, and choose 'Scene Settings'.
  
STAGING AND LIVE SERVERS
+
Follow these instructions on how to set the scene/upload settings: [[Regions/Upload Settings|Upload Settings]] or watch this video tutorial: [[Videos/Scene_Settings|Scene Settings]]
  
When you upload a region it will deploy first on the Space staging servers; staging.sine.space
+
*For export settings, follow these instructions: [[Regions/Export Settings|Export Settings]] or watch this video tutorial: [[Videos/Export_Settings|Export Settings]]
  
Regardless of your subscription level, you can upload as many regions as you want to the staging server.
+
*For platform settings, follow these instructions: [[Regions/Platform Settings|Platform Settings]] or watch this video tutorial: [[Videos/Platform_Settings|Platform Settings]]
  
Once on the staging server your region will have an obscenity and security review by a member of the Space team. This review is to ensure the maturity ratings are appropriate and that nothing in the scene could crash the servers or severely impair performance for other users.
+
*For how to submit your region, follow these instructions: [[Regions/Submission|Submitting Region]] or watch this video tutorial: [[Videos/Region_Submission|Region Submission]]
  
If you have a Level 5 subscription you can bypass this manual review and push directly to the live servers yourself.
+
* For region management, see this page: [[Regions/Management|Region Management]]
  
Your subscription level determines the number of regions you can release concurrently on the live server.
 
  
[[File:]] IMAGE PENDING
+
For more advanced settings, you can see our post zones page [[Regions/Post|here]] and also our lighting an interior page [[Lighting_an_Interior|here]].
  
 +
You can also see how Navigation Bake works [[Navigation_bake|here]], and we also have information on Occlusion Bake/Culling [[Occlusion_bake|here]].
  
 +
There are also some handy lighting tips [[Regions/Lighting|here]].
  
REGION INFO PANEL
 
  
When you are logged in to any region you can click the minimap in the top right corner to open the Region info panel for that region.
+
{{Creation Navbox}}
 
+
[[File:]]
+
 
+
 
+
 
+
REGION ACCESS
+
 
+
If you are the region owner you can then modify the access permissions;
+
 
+
[[File:]]
+
 
+
You can set the region to be public, limited to your friends or limited to specific individuals who you approve.
+
 
+
 
+
 
+
APPROVE USERS FOR REGION ACCESS
+
 
+
Any user can request access to one of your private regions;
+
 
+
[[File:]] IMAGE PENDING
+
 
+
You can approve or reject their application.
+
 
+
 
+
 
+
MEMBERS
+
 
+
In the members panel you can see who currently has access to the region and you can modify their permissions on an individual basis.
+
 
+
[[File:]]
+
 
+
 
+
 
+
MULTIPLE REGION MANAGEMENT
+
 
+
Your subscription level sets the number of concurrent regions you can deploy on the live servers.
+
 
+
[[File:]]
+
 
+
You can upload as many regions as you want to, and then enable or disable each region to set which ones are live at any time;
+
 
+
[[File:]]
+

Latest revision as of 09:43, 20 March 2019

Howtocreateashopbanner.jpg


There are different ways to build regions in space.

You can build region assets in other software packages and import into Unity.

You can use Unity's mesh shapes and terrain tools, and you can grab third party assets from the Unity Asset Store.

All of the pages linked here all refer to the Scene Export Settings/Scene Save Settings component:


Scenesavesettings.jpg


If you want to upload a region quickly, click on 'File>New Sinespace Scene' in Unity to instantly create a quick-start region.


Assemble your scene

You can upload any scene you create in Unity as a region in Space.

Once your scene is assembled you have two housekeeping tasks;


Remove Main Camera

When you create a new scene in Unity it will by default have a light and a camera.

You need to delete the camera (by selecting it in the Hierarchy window and clicking delete).


Camera.jpg


Add Landing Zone

You need to define where users arrive when they log in to your region; and what direction they are facing. To do this, once your scene is set up, from the top menu in Unity select Game Object / Create Other / Landmark.

OR;

If your Scene Heirarchy menu does not include Create other / Landmark, then;

Create empty object, then in the Inspector, add "Landmark behaviour" component.

This will place a new landmark item in your scene. In the Inspector window, set the type to Landing Zone and tick Spawn Point.

The in scene object is a yellow edged transparent plane which you can position anywhere in your scene.

The yellow arrow points in the direction your visitors will face when they arrive.

Be careful to position the landing zone slightly above the terrain; if a tall avatar's feet arrive below the terrain they may fall through.


Landmark.jpg

Adding a New Scene to your Region

This does not apply if you are using Multi-Scene Mode & Multi-Scene Editing.

You can have more then one scene in your region.
1 - Create a new scene in your current Sine.Spaces project.
2 - Double click the new scene in your Assets to load it into the Hierarchy.
2 - Design your scene. Be sure to save it.
3 - When ready to upload to the server click on 'Space' Scene Settings.
4 - Fill out the needed information, map pictures, and click Automatic Submission.
To teleport between one scene to another see [Teleport World]

Create a Home Region/Template

If you want to make your region as a home type, which could be edited by the users themselves, you need to attach a component which is called "Room Floor" to one of the item in the scene, usually the terrain or the object used as a field. With at least one room floor component, the region will show "Edit Room" button when you in it. You can add several Room Floor components to different objects, each floor can be shared to another user, gives him/her the authority to edit.
In your inventory, you will also find an item with same name of the region. This is a home template. You can use it in "Edit Room" -> "Design" function, to change the whole set of a region. Of course you could set a price for it when upload, so other user can buy it in the shop.

Please see our Room Floor page for more information on the Room Floor component.

Please pay attention that ALL the room edit info, like where you put some furniture is recorded in this "Room Floor" script. When you update your region, try not to remove this component in whatever situation. If you remove an old one then attach a new one to another object, the region update will cause all the users who are using your region template to find their region has gotten reset. If you must do that, try to let users of your template know this and be prepared for the overhaul updates.

If you want to add a day/night cycle to your home region/template, please do see our Day/Night Cycle page for more information.

Region Tutorials

After placing your landmark, go to 'Sinespace' at the top of Unity, and choose 'Scene Settings'.

Follow these instructions on how to set the scene/upload settings: Upload Settings or watch this video tutorial: Scene Settings


For more advanced settings, you can see our post zones page here and also our lighting an interior page here.

You can also see how Navigation Bake works here, and we also have information on Occlusion Bake/Culling here.

There are also some handy lighting tips here.