Frequently Asked Questions
- 1 General Questions
- 1.1 What platforms and hardware does Neos support?
- 1.2 What are Neos’ hardware requirements?
- 1.3 Can I put Neos in a window?
- 1.4 Can I play Neos on the desktop?
- 1.5 Is Neos open source?
- 1.6 What are the rules in Neos?
- 2 Beginner Questions
- 2.1 Are there any tutorials on how to use Neos?
- 2.2 What are the basic controls in Neos?
- 2.3 Where can I find an avatar to use?
- 2.4 Where can I find other users?
- 2.5 Can I explore other worlds?
- 2.6 How can I invite friends to my session?
- 2.7 How can I adjust the visibility of my session/how can I host a private session?
- 2.8 How do I navigate between sessions?
- 2.9 How can I mute myself?
- 2.10 I’m stuck/I’ve made a mistake.
- 2.11 How do I add someone as a friend?
- 2.12 Can others see my UI?
- 2.13 How do I save objects to my inventory?
- 3 Avatars and Assets
- 3.1 How can I import my assets?
- 3.2 How do I make an avatar?
- 3.3 What are the rig requirements?
- 3.4 Can I import my .unitypackage avatar?
- 3.5 Does Neos support dynamic bones for flowing hair, tails, etc?
- 3.6 How can I set my default avatar?
- 3.7 How can I change my home world?
- 3.8 How do I adjust the length of my arms/the fit of my avatar?
- 3.9 How do I set up full-body tracking?
- 3.10 Does Neos have an SDK?
- 4 Neos Features
- 5 Account and Supporter Perks
- 5.1 How do I get more cloud storage space?
- 5.2 I am a Patreon supporter, how do I link my account in NeosVR?
- 5.3 Why can I see my Patreon status in-game, but not in the Discord server?
- 5.4 When does Patreon charge, and when will I get my perks?
- 5.5 I need to pause my pledge/my pledge failed to process. What will happen to my storage?
- 5.6 How can I change my username in Neos?
- 5.7 Where can I find the Quest build?
- 5.8 How long does it take for my NCR purchase to transfer to my Neos account?
- 5.9 Troubleshooting
- 5.10 What do I do if Neos crashes/I encounter a bug?
- 5.11 How can I help improve Neos?
- 5.12 What do I do if I get a sync error?
- 5.13 General Troubleshooting and Known Issues
- 6 Original Wiki FAQ
- 7 What to do if the local database is corrupt?
What platforms and hardware does Neos support?
Neos is currently available on Windows, Quest, Android, and Linux. It supports all of the major headsets, including SteamVR/OpenVR, Oculus, and Windows Mixed Reality (via SteamVR).
Neos also supports a wide range of hardware peripherals. Neos supports as many trackers as SteamVR can provide (up to 64), 8 for full-body tracking (feet, knees, hip, chest, and elbows) with additional trackers able to be used to track objects.
Neos also supports the Leap Motion for finger tracking, Eye Tracking via the Vive Pro Eye and standalone modules, HTC’s lip tracking, and controllers such as the etee controllers.
If you are a hardware developer, and wish to send a Dev Kit for integration into Neos, please notify Frooxius Neos’ CTO.
What are Neos’ hardware requirements?
Neos requires a powerful quad-core CPU- at least a Haswell i5-4590 from Intel, Piledriver FX 8350 from AMD, or newer. Neos benefits greatly from strong single-core performance. At least 8 GB of memory is recommended, although Neos benefits greatly from 16 GB, or even 32 GB and above.
It is recommended to have a VR-capable card from either Nvidia (GTX 1060) or AMD (RX 570) although stronger GPUs have a high benefit for VR use by increasing resolution, and framerate.
Can I put Neos in a window?
Yes! At any point, you can press the key combination Alt + Enter to place Neos into a window. You can also specify command line arguments to change the windowed state and resolution.
-screen-fullscreen 0 -screen-width 1280 -screen-height 720 will place Neos in a 1280x720 window at launch.
Can I play Neos on the desktop?
Neos can be launched with the
-screen parameter if you have a headset connected to your PC, or will default to screen mode if no VR hardware is detected.
Screen mode is not officially supported at this time, and is primarily used for debugging purposes. Official screen mode support will be coming at a later time after further development on VR.
Can I play with a controller?
Neos does not presently support gamepad use, although it may support them, and other peripherals, e.g. racing wheels in the future.
Is Neos open source?
Currently, most of Neos is not open source. Neos is currently being developed by a small team and it is uncertain what the implications of open sourcing right now would be.
Does Neos support modded clients?
As per the EULA (https://store.steampowered.com/eula/740250_eula_0), users are not permitted to modify, decompile, or reverse engineer Neos. However, we have a sample library (https://github.com/Frooxius/NeosSampleLibrary) and API documentation (http://wiki.neosvr.com/docfx/api/) for use in creating plugins for Neos.
Is Neos running on Unity?
Most of Neos is running on the FrooxEngine, a custom-made engine crafted over the span of numerous years since around 2015 and around five hundred thousand lines of code, not including third party libraries.
Unity is used primarily for its renderer, the runtime environment (Mono/.NET), and interfacing with the audio system.
What are the rules in Neos?
Be excellent to each other. Details can be found in our Guidelines page.
How can I report a user?
If a user is in clear, and/or repeated violation of the guidelines you may report it to a Neos Moderator. For more information you can see our Moderation page.
Where possible, it is preferable that users resolve their own conflicts by use of the tools they have available to them in the form of the permissions system, muting, etc.
How can I protect myself from malicious users?
Neos offers a versatile permissions system that allows users to control how their sessions are run. Worlds in Neos are created with a set of permissions by the world’s creator.
Users that host sessions from these worlds are able to assign permission levels separately for each user in a session. ProbablePrime has created a useful |series of tutorials on how to effectively manage permissions
How can I identify Neos Team members, and moderators?
- Neos Team members can be identified by a yellow name, and a Neos logo badge above their name.
- Moderators can be identified by the moderation shield badge (a silver Neos logo) above their name. You can verify these badges through the session menu as they will be displayed alongside their names there as well.
Are there any tutorials on how to use Neos?
The NeosVR Wiki has a wide range of Tutorials.
Our users are also very welcoming, and helpful, and often willing to lend a hand to each other either in Neos, or on Discord.
What are the basic controls in Neos?
Navigation and movement are assigned to the joystick, primary actions are assigned to the trigger (e.g. activating buttons), secondary actions are achieved by a joystick/touchpad click (e.g. jumping, tool use), grabbing/moving objects in a world is achieved with the grip button.
The context menu button is used to access context-sensitive actions, and other controls such as undo/redo, and your locomotion modes (these will be moved in a later UI update). Additional controls including screen mode controls can be found on our Basic_Controls page.
Where can I find an avatar to use?
Inside of the inventory, there is an Avatars folder inside of the Neos Essentials which contains a variety of avatars which are free to use, and modify. Additional avatars can be found through public folders shared with you, or found inside of worlds.
You can also use the avatar creator to turn any object into an avatar, including rigged avatar models you import.
How can I equip an avatar?
Avatars from your inventory you can quick-equip by selecting them once to highlight them, and then pressing the yellow lightning bolt. Avatars placed in the world can be equipped by clicking on them.
Where can I find other users?
Active sessions will be listed at the top of the worlds list under the “Worlds” tab of your dashboard. You can filter the listing to include only sessions with active users by using the “Active Sessions” search preset.
Can I explore other worlds?
There are a wide range of worlds to be explored. They can be found in the World Browser. The World Browser is in the Worlds section of your toolbelt. You can scroll through the wide range of uploads spanning since Neos’ inception, or you can filter the results.
The Featured search preset will display community-created worlds the Neos Team wishes to showcase.
You can also search for specific tags in the search bar at the top, in addition to the numerous search presets for themed worlds, e.g. games, educational content, social hangouts, and more.
How can I invite friends to my session?
From the Friends button on your toolbelt, select the friend in your list you wish to invite, then press Invite Here.
How can I adjust the visibility of my session/how can I host a private session?
While in an active session, you can do this through the Session menu of your toolbelt. Open the session Settings, then select your desired privacy level anywhere in the range from Anyone to Nobody/Invited Users.
While your status is set to Invisible, all sessions you create will be set to private by default.
Any sessions you create, or join in Neos remain open, and active until you close them, close Neos, or are removed from them (e.g. by an AFK kick). To navigate, and manage your open sessions, you will find them listed at the top of the world browser. Your active sessions will be listed first, and have a yellow border around them. You can switch sessions by clicking on the session, and pressing ‘focus’ on the pop-up modal.
To close an active session, you can press the ‘X’ button at the top right corner of the session, and press close, or you can use the ‘close world’ button on the home screen of your dash.
How can I mute myself?
On your dashboard, you will find a range of voice control options on a facet in the top left corner. Clicking on them will set your voice mode.
Mute is a toggle that will silence you, Whisper places a whisper bubble around you that dampens outside noise, and prevents anyone outside of the bubble from hearing you, Normal is the typical spatialized voice mode, Shout has increased volume, and range- good for large maps, and Broadcast disables spatialization, allowing you to be heard from anywhere (like a voice call on other platforms.)
To un-mute yourself, press the mute button again to restore your previous voice mode.
I’m stuck/I’ve made a mistake.
If you are stuck in a part of the world, if it’s available, you can use the Noclip locomotion mode to escape. To do so, open your context menu, click on the locomotion button, and choose from the available modes in the world.
In this same menu, you can undo your previous actions such as moving objects with the Undo button.
There are also the emergency respawn, and emergency disconnect gestures. To respawn yourself, hold your controllers up to your face, hold one grip button, and press both context menu buttons, and wait a few seconds until your controllers begin to vibrate. To disconnect from a world immediately, you can hold up the controllers to your face, and just hold both context menu buttons.
How do I add someone as a friend?
To add someone as a friend, you can click on their nameplate, and press the Add Friend button, or you can search for a user through the Friends button on your toolbelt, and typing in the search field at the top left.
Can others see my UI?
Other users are unable to see your UI by default, however some UI elements such as the context menus, and your interaction lasers can be publicly visible from within the session.
How do I save objects to my inventory?
To save objects to your inventory, grab the object you wish to save, and press the green plus button. You can only save into a folder that you’ve created, and not public folders such as the Neos Essentials.
Note: Some worlds and objects are set-up with permissions that prevent saving them to your inventory.
How can I organize my inventory?
You can create a new folder to save objects into by pressing the green plus button, and naming the folder.
It is not presently possible to rearrange existing inventory locations, so to do so, you will need to spawn the object out, and save it into the new folder, then delete the original with the red trash can icon. This process will be streamlined in a future UI update.
Public folders are denoted by their orange coloration. They are created by users, and their contents are publicly listed.
ProbablePrime has a world called The Directory (http://cloudx.azurewebsites.net/open/world/U-ProbablePrime/R-9ce872e1-ffb8-4194-bb91-3d3ab5f157a1) in which public folders can be found, and saved to the inventory like any other object. Public folders saved to the inventory can be navigated like any folder you own.
To create a public folder, you can highlight a folder in your inventory, and press the beige envelope icon to create a public folder object which can be used to save the folder into the inventory of other users.
Public folders are not intended for use in sharing sensitive data as the objects contained within are publicly viewable. To un publish a folder, you can press the purple hand icon.
To share privately with a friend, you can let them save a copy of the object as you spawn it out, or send it to them through the messaging system by gripping the object, and pressing the green plus button next to the message entry box at the bottom right of the Friends UI.
Avatars and Assets
How can I import my assets?
Assets can be brought into Neos by either dragging, and dropping them from your PC’s file browser onto the Neos window, copying and pasting the asset or a link to the asset into Neos window or through the Paste Content From Clipboard button found in the session menu.
You can also navigate your filesystem from the File Browser found under the Tools grouping of the toolbelt.
For many assets an Importer UI will appear with options to set up the detected asset as an object for use in Neos.
What kinds of assets does Neos support?
Models, textures, sounds, fonts, LUTs, and more- Neos is capable of importing a wide range of assets in a wide range of commonly accepted formats.
How do I make an avatar?
Avatars are created through the Avatar Creator found in the Tools group of your toolbelt. Any object can be turned into an avatar including rigged models you’ve imported.
Importing An Avatar:
Once you’ve opened the asset in Neos, a Model Importer UI will appear. For avatars you will want to select 3D Model > Regular > Auto Humanoid Height. You can either press Import Now!, or Advanced Settings if you wish to modify the setup, e.g. changing which materials the model is setup with.
Using the Avatar Creator:
To use the Avatar Creator, open it from the Tools section of your toolbelt. You will see spheres containing a HMD, and hands. Align those with your avatar’s. You can optionally set up the hips, and feet if you wish to make your model compatible with full-body tracking. This can also be set up later through the Full Body Calibrator tool.
You can also select the Protect Avatar option to prevent other users from equipping or saving a copy of your avatar.
My avatar has no textures.
Sometimes an avatar may import without their textures. This is something that can be resolved from within Neos using the MaterialTip, and DevToolTip. [Extract the materials | https://www.youtube.com/watch?v=pKf7iKaVrX0] from your avatar, and assign the textures you’ve imported by dragging them into their appropriate fields from within the Material Inspector.
What are the rig requirements?
Neos requires a general bone naming convention, and hierarchy to be set-up automatically as an avatar. Avatar rigs set-up for other platforms should generally be compatible with Neos.
A full list of the humanoid rig requirements can be found on Humanoid_Rig_Requirements_for_IK.
A sample rig can be found here: https://drive.google.com/open?id=1jlNeTwg2ZKSv1wD7HMifZ-RtTTN6mGMw
Can I import my
Not directly, no.
.unitypackage is a compressed file format specific to use in Unity. However, if your model exists in a raw form such as a .fbx file within the project folder in Unity, you can use that to import, instead.
What about my custom shaders?
Custom shaders are not supported at this time, as there is no way to compile JIT shaders at runtime. The shaders need to be compiled into Neos itself.
However- a wide variety of visual effects can be achieved through the use of Logix, and components from within Neos itself!
Does Neos support dynamic bones for flowing hair, tails, etc?
Yes! To do so, open up your avatar with the DevToolTip, navigate to the bone you wish to start the chain from, and attach the DynamicBoneChain component. Once it’s attached, browse to the bottom of the component, and select the Setup From Children button.
Once the bone chain has been added, you can modify a wide variety of properties such as the elasticity, gravity, and whether or not the bone chain is grabbable via the IsGrabbable checkbox. Dynamic bones can even be brushed around by your hands.
How can I set my default avatar?
After you have clicked to select an avatar from your inventory, press the purple heart icon to set an avatar as your favorite. An avatar can be unset as your favorite by pressing the button again, or choosing another avatar as your favorite.
How can I change my home world?
Like setting your default avatar, you can set a favorite world from a world orb in your inventory. Select the world orb in your inventory, and press the purple heart icon to favorite it.
You can only use worlds that you have created, or saved a copy of using Save > Save Copy or Save > Save As from the Save menu in your toolbelt.
How do I adjust the length of my arms/the fit of my avatar?
From a DevToolTip, inspect the root of your avatar, and look through the VRIK component settings. You will find a value called ArmLengthMlp under each of the leftArm and rightArm. Adjusting these values slightly will give your arms a little more reach if they’re too short, or make your arms bend less if they’re too long.
Additionally, on the VRIKAvatar component is the
HeightCompensation property. This will scale your entire avatar down, or up to better match your body. This setting is also more easily accessible through the Full Body Calibrator tool.
How do I set up full-body tracking?
Use the Full Body Calibrator found in the Tools section of your toolbelt. If this is the first time doing so, ensure your height is set correctly to your real height, confirm your trackers are recognized, then press the Start Tracker Calibration and align yourself as closely as you can in your playspace to the outline avatar.
Once you’ve calibrated your trackers, you can proceed to the avatar calibration. You should only need to calibrate your trackers once so long as they remain in the same position, and orientation on your body.
My avatar is moving strangely with FBT.
Some avatars can be oddly proportioned for full-body tracking. Like when an avatar is initially set up in the Avatar Creator, on the Full Body Calibrator, you will find options to help you fit your avatar to your body. The height compensation slider will grow or shrink your avatar’s size to better fit your own- a value around 0.92-0.95 is a good starting point.
If your chest and neck are moving strangely, you may wish to lower the target of your avatars hips by gripping them, and pulling them down, paying attention to the blue avatar rig visual.
If your avatar sinks into the floor when ducking, try raising the foot targets up to around their shins, or until you notice the legs begin to move upward on your avatar.
Most avatars can work quite well in full-body with some tweaking.
Does Neos have an SDK?
Neos does have an SDK. It is available to Patrons of the Gunter tier. It is presently in early access, and is mostly useful for batch importing pre-existing Unity assets. A proper, and more fully-featured SDK is planned to be created at a later date.
For most creations it is recommended to import, and set things up from within Neos itself.
What is Logix?
Logix is the node-based visual scripting language of Neos. It forms the basis of many of the gadgets, toys, and game mechanics you will find within the various worlds our community have created.
It is a powerful tool for managing, and manipulating data within a world, opening vast potential to your creations.
Can I stream Neos?
The Camera Control panel also offers a variety of options to manipulate the camera.
OBS and Twitch Integration:
Within the camera control panel, you will find buttons bearing the OBS and Twitch logos.
The OBS websocket allows you to remotely launch, and begin recording or streaming from OBS: https://github.com/Palakis/obs-websocket/releases
Your Twitch chat can be viewed from within Neos by typing your channel name into the text entry field at the top of the Twitch Chat UI. You can pin the Twitch chat to you by pressing the yellow pin button, you can also make a publicly visible Twitch Chat UI by pressing the blue half-circle icon.
What is NCR?
Neos Credits (NCR) is the currency used in Neos. It is based on the ERC20 Ethereum blockchain, and is to be used, and traded for goods, and services from within Neos.
It is rewarded to our Patreon, and Ethereum backers.
It can presently be traded directly among Neos users, but in the future with the release of the Neos store, and marketplace, content creators will be able to license, and sell their creations within Neos.
Additional details about NCR can be found in the whitepaper: https://neosvr.com/whitepaper.pdf
What are tooltips?
Tools in Neos are used in a variety of world, asset, and object creation workflows. They are what drives your ability to create from within Neos. From simple brushes to draw, and paint, to complex and versatile tools such as the DevToolTip for general world manipulation, MaterialTip for texturing, and LogixTip for programming.
There are also other useful tools such as the GrabbableSetterTip to change whether or not you can grab and move an object, and the CharacterColliderSetterTip, which can make your environments collidable so you can walk on them.
These tools, and many more can all be found in the Essential Tools folder of your inventory.
Locomotion modules determine the types of locomotion that are available in a world. While a default set of locomotion modules exist in all of the template maps that many worlds are created from, a world creator may choose to modify, or remove certain locomotion modes from their world.
Details such as your speed, jump height, and whether or not you can climb on surfaces may change from world to world because of changes implemented by a world’s creator.
Account and Supporter Perks
How do I get more cloud storage space?
Additional cloud storage space is a perk awarded to our Patrons on Patreon. $1 per month will grant access to 5 GB of additional cloud storage, with additional storage space, and perks available at each successive tier.
Can I store things locally on my hard drive?
You can save worlds, and their contents into your Local Home, which will save the assets locally on your computer. These files are not stored on the cloud, or backed up, so if you store anything here, please regularly backup your local database at
If your Neos account email is the same as your Patreon email, linking should occur automatically within a six hour period. If it has not, or your Neos email address differs from your Patreon, please inform Shifty, and they will be able to help you in linking your accounts.
Why can I see my Patreon status in-game, but not in the Discord server?
Verify that you have linked your Discord account on Patreon: https://support.patreon.com/hc/en-us/articles/212052266-Get-my-Discord-role
When does Patreon charge, and when will I get my perks?
Our Patreon is set up to only charge users on the first of every month. Certain perks such as the Patreon badge, nameplate color, and the Discord role are assigned right away within a six hour period. Other perks such as increased storage space, and NCR are awarded upon the processing of your payment.
I need to pause my pledge/my pledge failed to process. What will happen to my storage?
It’s understandable that life can get in the way sometimes. Your support as a Patron is always greatly appreciated. In the event that you are over your storage limit when this happens, you will be unable to save any additional content to your cloud.
If this adversely affects you, let a member of the Neos Team know, and they may be able to help by temporarily raising your storage limit until you can resume your pledge.
How can I change my username in Neos?
To change your username in Neos, you can ask Shifty. Username changes are not to be taken lightly, so please carefully consider your desired username before changing it.
Where can I find the Quest build?
The Quest build is a perk of the Gunter tier on Patreon. It is in early access, but it can be accessed through a beta key for Steam found in the #📱android-testers channel here on Discord.
How long does it take for my NCR purchase to transfer to my Neos account?
Transactions are manually processed by Karel, and should be complete within two days time of the initial purchase. If you have any concerns about your transaction, please notify Karel, and he can verify its status, and update you accordingly.
What do I do if Neos crashes/I encounter a bug?
In the event that Neos crashes, or you encounter a bug, collect your logs, and report it either in the #🐜bugs-and-feedback channel or to Shifty.
Where can I find the log files?
Neos logs can be found in the Neos installation directory. This is most easily accessed through Steam. Right click on Neos VR in your Steam library, and select Properties, then Local Files, then Browse Local Files.
Here, you will find a Logs folder which contains logs named by build number, the date, and time of the log’s creation. When submitting them, select the most recent logs which correspond to the session the issue occurred in.
Unity Player.log files can be found by pressing Windows Key + R and entering
%USERPROFILE% then OK. The Player.log is overwritten each time you launch Neos, so make sure to collect it right away after you encounter a crash, or bug. If you have launched Neos once since the issue occurred, the contents will be in the Player-prev.log file. If you’ve launched Neos twice or more since the issue occurred, the Player.log file will be gone as it will have been overwritten.
In the event that you crash, Neos will attempt to create crash logs, and memory dumps that are located in a Crashes folder found at
%USERPROFILE%. Inside of the crashes folder are folders for each crash logged, and inside of each is an error.log file, a Player.log file, and a memory dump.
If they exist, submit the error.log, and Player.log file from the crash folder alongside the Neos log from your installation folder. Otherwise, just submit the Neos log, and the Player.log.
How can I report a bug I’ve found?
If the bug is replicable, and you have all of the details necessary to recreate it, create a new issue on our GitHub (https://github.com/Frooxius/NeosPublic/issues) detailing all that you know about the issue, and posting your logs about the issue in the post, or submitting them directly to Shifty if you do not wish to post them publicly.
If you are unable to immediately replicate the issue, post in the #🐜bugs-and-feedback channel with as many details as you can provide on the issue, and submitting your logs to Shifty for investigation.
If you are uncertain if a behavior is actually a bug, you can ask for clarification in either the #🐜bugs-and-feedback, or the #❓questions-help channels.
How can I help improve Neos?
Become a Danger Tester!
If you wish to help test soon-to-be-released features, you can become a Danger Tester! Danger Testers are designated by the Danger Tester role assigned to them here on Discord. If you wish to help, please send Shifty a message requesting the role.
When a build is available to be tested, Danger Testers will be notified. To access the branch in Steam, right click on Neos VR in your Steam library, select Properties, then navigate to the Betas tab, and opt-in to the danger-nightly branch.
You may provide feedback, and bug reports through the #📋testing channel.
Please do not use the danger-nightly branch recreationally so as not to needlessly split the community. The branch should only be used for explicitly testing the reported features. There is no guarantee of stability on this branch, so it shouldn’t be used for average uses such as world creation, etc.
How to update the nightly?
Sometimes the builds are updated faster than Steam will recognize on your client. To ensure you’re on the correct version, try restarting Steam.
What do I do if I get a sync error?
Sync errors can occur when a local asset is out of sync with the data stored on the cloud. This can occur for a variety of reasons. You can check the log to see which files are conflicting, and whether the local, or cloud storage is newer.
There are two command line arguments that pertain to the cloud database.
-DeleteUnsyncedCloudRecords will delete the local unsynced copies of the cloud records from your local database. Only use this command if you are certain you will not lose important data when it is deleted.
-ForceSyncConflictingCloudRecords will force the conflicting cloud records to sync, overwriting the existing cloud data with the local files. This can overwrite your cloud data with an earlier version, so use it carefully.
These command line arguments can be entered in the launch options through Steam. To access them, right click on Neos VR in your library, select Properties and Set Launch Options. Enter the command exactly as it appears above, and run Neos. After the first time you’ve run Neos, make sure to remove the command so it doesn’t apply on subsequent launches.
General Troubleshooting and Known Issues
In the event that Neos fails to launch, assets fail to load, or other strange issues occur on each launch, Neos’ database may potentially be corrupted. If this corruption is detected, Neos will notify you of the issue, and will attempt to repair the database on the next launch.
Should Neos continue to exhibit issues, it may be necessary to reset your local database.
To do this, press Windows Key + R and enter
%USERPROFILE% and backup, rename, or delete the NeosVR folder found here. If you delete this folder, you will lose any unsynced data, and your local home, and will need to log-in again the next time you launch Neos. All of your account data, and assets saved to your inventory will be available from the cloud when you sign in.
For additional issues that aren’t resolved by this, refer to the following:
Textures aren’t loading/are checker boarded.
Go to your Windows Settings, Network & Internet, Proxy and verify that all proxy settings are disabled. If that alone doesn’t work, you may also verify that Neos’ network connection isn’t being blocked by any antivirus, or firewall software, or the possibility of the routing being tampered with by VPN software.
Neos VR is crashing to the desktop on Windows 7.
Neos does not officially support Windows 7 as it is past End of Life. However, creating an empty file with no extension in the root of your C drive called UseUnityAudioAPI may resolve the issue.
Neos doesn’t load on Windows 10 N.
If you are on Windows 10 N, you may be missing necessary dependencies to run Neos. Try downloading the Media Feature Pack for N versions of Windows 10: https://www.microsoft.com/en-us/software-download/mediafeaturepack
Neos is visible on the desktop, but not in my HMD.
If you are on Oculus, ensure that you are running Neos through the Oculus runtime. To do so, make sure SteamVR isn’t running when you launch Neos from Oculus Home.
You may also specify your device as Oculus Rift in the Neos Launcher, accessed from Neos’ installation folder, or from the Launch Configuration Tool option when opening Neos from your Steam library.
You may also manually specify the -RiftTouch command line argument through the launch options in Steam. To access them, right click on Neos VR in your Steam library, and select Properties then Set Launch Options.
You can also force the SteamVR runtime instead either by using the Play Neos VR with SteamVR runtime forced on option, specifying your device as SteamVR in the Neos launcher, or using the -SteamVR command line argument in the launch options in Steam.
None of the above apply/I’m still in need of help.
In the event that your issue isn’t resolved by any of the above solutions, please feel free to contact Shifty, or reach out to other users through the #❓questions-help channel.
Original Wiki FAQ
User:ProbablePrime is in the process of merging and consolidating these two FAQs, I wanted to enable the FAQ to be translated and updated by everyone so here's my attempt :). Let me know if you have any questions.
If you registered with the same email address in Neos as you have in Patreon, then the process is automatic. Can take up to 12 hours for it to pick up. You get the Patreon badge in Neos and access to Patreon Swag and Patreon only worlds right away after it does.
Increased storage and CDN get activated after the first payment from Patreon goes through, this is at the beginning of each month.
If you have different email address on Patreon, let Frooxius know via DM on Discord and he'll link it up manually.
Where can I find tool tips?
Open the main menu that looks like a circular Neos logo. Click on the Content Hub. Look for the section titled "Tutorials". Each tutorial world has explanations of how to use the various tool tips. Place your controller over a tool tip and double-click your grip buttons. This will attach the tool tip to your controller. It's typical practice to collect these in your local home for quick access. Use the world manager (connected 360 worlds widget) to go back to your local home and double-click the grip buttons again to place the tool tip into your world. Collect them all as you learn about them!
How do I change my skybox?
By using the material gun, you can use the secondary action on your controller to collect any imported 360 photo as a material. Then you can point the material gun at the sky and pull your trigger.
Where can I find log files?
First you need to find the directory where NeosVR is installed.
If installed on Steam:
1) Open your Steam client and find NeosVR
2) Right click NeosVR and select Properties
3) Go to the "LOCAL FILES" tab
4) Click the "BROWSE LOCAL FILES..." button
You can find the log files in the "Logs" folder next to the Neos executable.
Additional Unity Log:
Sometimes some errors are in the Unity's own log. You can find it here:
1) Go to the "C:\Users\<your username>\AppData\LocalLow\Solirax\NeosVR" folder
2) It's the Player.log file (or Player-prev.log if you've launched Neos again)
If you crash:
If you experience a hard crash, please check the following folder for any crash dumps, which can be crucial in resolving the issues:
1) Go to the "C:/Users/<your username>/AppData/Local/Temp/Solirax/NeosVR/Crashes"
2) ZIP all the folders there (if any) and send to the developers (ideally directly to Shifty#7944 on Discord).
3) Provide as much info as you can about what occurred before the crash - anything you have been doing in Neos
To gather logs on the Quest build of Neos, you will need to use ADB, and enter the command
adb logcat -s Unity >> Unity.log. Neos must be running when you are gathering the log files.
What to do if the local database is corrupt?
In some cases the Neos' local database can become corrupt, preventing Neos from launching or causing things to not load (either worlds or inventory items). You will be notified of this corruption in Neos and asked to restart. If the automatic repair doesn't work and Neos still has issues or refuses to start, you'll need to clear the database fully. Things on your cloud account will be preserved, anything unsynced and stored in local home will be lost:
1) Go to "C:\Users\<username>\AppData\LocalLow\Solirax"
2) Rename "NeosVR" to "NeosVR_Backup"
3) Launch Neos again and Login to see if things work again.
4) If everything is in place and you have everything on the cloud, you can delete NeosVR_Backup folder. Otherwise you can switch back to the old profile by renaming the folders again (so NeosVR_Backup is named NeosVR) and uploading your local worlds to the cloud, before switching to the profile.
If that doesn't work and you have critical worlds that you need preserved, you can contact Neos Team for assistance. Make sure to double check whenever everything loads with a fresh profile before deleting NeosVR_Backup, so you don't lose any data.
Where does Neos save my worlds and data cache?
Neos saves all the asset files and database in the
C:\Users\<username>\AppData\LocalLow\Solirax\NeosVR and temporary cached files in
Asset files shouldn't be edited manually though, as they are Neos managed and making changes to them can lead to the loss of your data or strange errors.
Relocating Cache and Data Files
To relocate the Cache and Data path for Neos you can use Neos' Command Line Arguments.
- -DataPath D:\NeosData
- -CachePath D:\NeosData
Is Neos open source?
Currently most of it is not, however we would like to open source it at some point in the future, to allow community make contributions to the core of the project as well or build new exciting applications. Neos is currently being developed by a small team and it is uncertain what the implications of open sourcing right now would be, especially on our ability to work on this full time.
Can I separate the engine and use it as standalone?
Right now this is not possible to do as everything happens in-engine. You can load extra CLR assemblies into the process at startup (fully dynamic loading is coming later), but custom integrations aren't available right now.
It's a possibility for the future of the project (especially if it's open sourced), although low priority, as it goes against its main philosophy, although it could be quite useful for many new projects and experimentation.
Can I change the Spawn point of my world?
Yes. Equip the developer tooltip and go to Create New > Object > Spawn Area. This will spawn a yellow circle which you can position where you want users to spawn. Make sure to position the spawn area itself and not just the visual.