Frequently Asked Questions
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 create a Feature Request or sent a Direct Message on Discord to Shifty, and she will forward your request/details internally.
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?
Yes! With no VR hardware it will be launched by default, and while in VR it can be toggled to at any point by pressing F8.
The screen mode is under active development, and additional functionality is still to be developed.
Can I play with a controller?
Neos currently offers preliminary support for gamepads, e.g. basic functionality such as moving, turning, jumping, and using the context menu. Additional support will be added later.
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 (https://wiki.neos.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, we recommend reporting it via our moderation website.
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. You can read more on our Moderation page.
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.
- Mentors can be identified by a green name, and Neos help logo (green Neos logo).
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 Dash Menu. 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 Contacts button on your Dash Menu, 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 Dash Menu. 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 contact?
To add someone as a Contact, you can click on their nameplate, and press the Add Contact button, or you can search for a user through the Contacts button on your Dash Menu, 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.
A list of public folders is available. It contains links. These links can be pasted into Neos to generate a public folder object, then saved to the inventory.
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. To copy a public folder's link, you can grip it open the context menu, and press the copy link button.
Public folders are not intended for use in sharing sensitive data as the objects contained within are publicly viewable. To unpublish a folder, you can press the purple hand icon.
To share privately with a contact, 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 at the bottom right of the Contacts 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 in your Dash Menu.
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 Home section of your Dash Menu. 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 Home section of your Dash Menu. 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 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 the Session section of your Dash Menu.
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 Home section of your Dash Menu. 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 she 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 Shifty know, and she may be able to help by temporarily raising your storage limit until you can resume your pledge.
How can I change my display name in Neos?
To change your display name in Neos, you can ask Shifty so she may change it. Please provide her with your Neos account name/email, and desired (available) display name. Display name availability can be determined by searching the contacts list in-app. Display name changes are not to be taken lightly, so please carefully consider your desired display name before requesting it changed.
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.
How do I turn on two-factor authentication?
Once enabled, every credit transaction (NCR, KFC) will require a 2FA code to complete.
Optionally you can enable 2FA requirement for login by sending the /enableLogin2FA command to the Neos Bot account. IMPORTANT: Currently this breaks login at the account.neos.com website (which is also used for wiki login), as it's not been updated with 2FA support yet. You can suppress 2FA for three minutes for logging in on account.neos.com by sending the /webLogin command to the Neos Bot account.
Using "Remember Me" will not require a 2FA code every time you start Neos. If you want even more increased security, do not check this option and manually log in every time. However this shouldn't pose a significant risk, as the "remember me" token is invalidated every time you log in.
You can disable 2FA requirement for login by sending the /disableLogin2FA command.
Take care to protect your secret code and recovery codes. If you lose them, you'll PERMANENTLY lose access to your account!
AdminX and Headless support 2FA login as well. Note that with Headless you cannot use auto-login in the configuration file with 2FA; only the dynamic "login" command will work.
Can I delete my account
Yes, please see this article
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 for her to review. Preferably you can also file a GitHub issue on our issue tracker here.
Where can I find the log files?
Follow this guide
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 for her to review 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 submit your logs to Shifty so she may investigate them.
If you are uncertain if a behaviour is actually a bug, you can ask for clarification in either the #🐜bugs-and-feedback, or the #❓questions-help channels.
How can I report a Security Issue / Exploit?
If you've found an issue that you think is a security issue or an exploit that you'd like to report then please review our Security & Exploit Reporting Policy.
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 on Discord by reacting in the #👋welcome-and-links channel.
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 isn't finishing?
See this guide
General Troubleshooting and Known Issues
Textures aren’t loading/are checker boarded.
See this guide
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
My database is frequently corrupting/my primary drive is out of space.
See this guide
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 and let her know what the issue is, or reach out to other users through the #❓questions-help channel.