常见问题

From Neos Wiki
Jump to navigation Jump to search
This page is a translated version of the page Frequently Asked Questions and the translation is 20% complete.
Outdated translations are marked like this.
Other languages:
Deutsch • ‎English • ‎français • ‎čeština • ‎中文(中国大陆)‎ • ‎日本語 • ‎한국어

一般问题 Neos支持哪些平台和硬件?

Neos目前可用于Windows、Quest、Android和Linux。它支持所有主要的头戴式受话器,包括SteamVR/OpenVR、Oculus和Windows混合现实(通过SteamVR)。

Neos还支持广泛的硬件外围设备。Neos支持SteamVR所能提供的尽可能多的追踪器(多达64个),8个用于全身追踪(脚、膝盖、臀部、胸部和肘部),额外的追踪器能够用于追踪物体。

Neos还支持Leap Motion的手指追踪,通过Vive Pro Eye和独立模块的眼球追踪,HTC的唇部追踪,以及诸如etee控制器等控制器。

如果你是一个硬件开发者,并希望发送一个开发工具包以整合到Neos中,请创建一个Feature Request或在Discord上直接发送消息给Shifty,她会在内部转发你的请求/细节。

Neos的硬件要求是什么?

Neos需要一个强大的四核CPU--至少是英特尔的Haswell i5-4590,AMD的Piledriver FX 8350,或更新的版本。Neos从强大的单核性能中受益匪浅。建议使用至少8GB的内存,尽管Neos从16GB,甚至32GB以上的内存中获益。

建议使用Nvidia(GTX 1060)或AMD(RX 570)的VR功能卡,尽管更强大的GPU通过提高分辨率和帧率对VR使用有很大好处。

我可以把Neos放在一个窗口吗?

是的! 在任何时候,你都可以按组合键Alt + Enter将Neos放入一个窗口。你也可以指定命令行参数来改变窗口状态和分辨率。

例如,-screen-fullscreen 0 -screen-width 1280 -screen-height 720将在启动时将Neos置于1280x720的窗口中。

我可以在桌面上玩Neos吗?

是的!在没有VR硬件的情况下,它将被默认启动,而在VR中,它可以通过按F8键在任何时候切换到。

屏幕模式正在积极开发中,其他功能仍有待开发。 我可以用控制器玩吗?

Neos目前提供了对游戏板的初步支持,例如基本功能,如移动、转向、跳跃和使用上下文菜单。更多的支持将在以后添加。

Neos是开源的吗?

目前,Neos的大部分内容都没有开放源代码。Neos目前是由一个小团队开发的,现在还不确定开放源代码的意义是什么。 Neos是否支持修改的客户端?

根据EULA(https://store.steampowered.com/eula/740250_eula_0),用户不允许修改、反编译或反向工程Neos。然而,我们有一个样本库(https://github.com/Frooxius/NeosSampleLibrary)和API文档(https://wiki.neos.com/Docfx/api),用于为Neos创建插件。

Neos是否在Unity上运行?

Neos的大部分内容都是在FrooxEngine上运行的,这是一个自2015年左右起历经无数年精心打造的定制引擎,大约有50万行代码,其中不包括第三方库。

Unity主要用于其渲染器、运行环境(Mono/.NET),以及与音频系统的接口。 Neos中的规则是什么?

彼此之间要有良好的关系。详情可在我们的指南页面找到。 我如何举报一个用户?

如果一个用户明显地,和/或重复地违反了准则,我们建议通过我们的审核网站进行报告。

在可能的情况下,用户最好通过使用权限系统、静音等工具来解决他们自己的冲突。你可以在我们的节制页面上阅读更多内容。

我怎样才能保护自己免受恶意用户的侵害?

Neos提供了一个多功能的权限系统,允许用户控制他们的会议如何运行。Neos中的世界是由世界的创建者用一套权限创建的。

主持这些世界的会话的用户能够为会话中的每个用户分别指定权限级别。 ProbablePrime创建了一个有用的|关于如何有效管理权限的系列教程 如何识别Neos团队成员,以及版主?

  • Neos团队成员可以通过一个黄色的名字,以及他们名字上方的Neos标志徽章来识别。
  • 版主可以通过他们名字上方的版主盾牌(银色的Neos标志)来识别。
  • 导师可以通过绿色的名字,和Neos帮助标志(绿色Neos标志)来识别。

你可以通过会议菜单验证这些徽章,因为它们也将在那里与他们的名字一起显示。

初学者问题 是否有任何关于如何使用Neos的教程?

NeosVR Wiki有大量的教程

我们的用户也非常热情,乐于助人,经常愿意在Neos或Discord上互相帮助。 }

Neos中的基本控制是什么?

导航和移动被分配给操纵杆,主要行动被分配给触发器(如激活按钮),次要行动由操纵杆/触摸板点击实现(如跳跃、工具使用),抓取/移动世界中的物体由握持按钮实现。

上下文菜单按钮用于访问上下文敏感的操作,以及其他控制,如撤销/重做,以及你的运动模式(这些将在以后的用户界面更新中被移动)。包括屏幕模式控制在内的其他控制可以在我们的Basic_Controls页面找到。 我在哪里可以找到一个可以使用的头像?

在库存中,Neos Essentials中有一个Avatars文件夹,其中包含各种头像,可以自由使用和修改。其他的头像可以通过与你共享的公共文件夹找到,或者在世界中找到。

你也可以使用头像创建器将任何物体变成头像,包括你导入的已装配好的头像模型。 我怎样才能装备一个头像?

你可以从你的库存中快速装备头像,方法是选择它们一次以突出它们,然后按黄色的闪电。放在世界中的头像可以通过点击它们来装备。 我在哪里可以找到其他用户?

活跃的会话将被列在你仪表板的 "世界 "标签下的世界列表的顶部。你可以通过使用 "活跃会话 "搜索预设来过滤列表,只包括有活跃用户的会话。 我可以探索其他世界吗?

有大量的世界可供探索。它们可以在世界浏览器中找到。世界浏览器在你的Dash菜单中的世界部分。你可以滚动浏览自Neos成立以来的大量上传内容,或者你可以过滤结果。

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.

How do I navigate between sessions?

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.

What are public folders/how can I share items?

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 .unitypackage avatar?

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.

Neos Features

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?

So long as the content is within our Guidelines, and the terms of use of the platform you stream to, you are welcome to share your time in the metaverse with others. Please utilize the Mirror To Display option found within the Camera / Streaming tool in the Home section of the Dash Menu. While Mirror To Display is enabled, a LIVE badge will appear over you head to notify other users that you are recording.

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:

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 %USERPROFILE%\AppData\LocalLow\Solirax\NeosVR

I am a Patreon supporter, how do I link my account in NeosVR?

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?

You can enable 2FA on your dash from the tools facet, which has a "Setup 2FA" option. To set it up you'll need a TOTP authenticator app, like Authy or Google Authenticator.

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

Troubleshooting

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?

There are Two Main Log File types which Neos Produces:

  1. Regular Log Files
  2. Player.log Files

When asking for logs we usually need the First type but may ask for the second one on occasion. Start with providing the first.

Regular Log Files

Neos logs can be found in the Neos installation directory. For the Steam build of Neos, This is most easily accessed by right clicking on Neos VR in your Steam library, and selecting Properties, then Local Files, then Browse Local Files. For the standalone build of Neos, you can right click the Neos launcher shortcut (the one with the blue Neos logo), and open file location, then open up the "app" folder.

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.

Player.log Files

Unity Player.log files can be found by pressing Windows Key + R and entering %userprofile%\AppData\LocalLow\Solirax\NeosVR 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.

Crash log and memory dump

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%\AppData\Local\Temp\Solirax\NeosVR\Crashes. 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 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?

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 regular log files to see which files are conflicting, and whether the local, or cloud storage is newer. Just open these in a text editor to view them.

Do not:

  • Delete your Neos data or cache files.
  • Try to save and sync any more items/worlds.
  • Send any objects or voice messages through the Contacts tab.
  • Change any settings.

Before figuring out what the problem or error is. These steps are likely unnecessary and could cause more problems later on if you haven't resolved the initial syncing error.

Once the log file is open, look for the phrase "unsynced record", "failed sync", "Record preprocessing failed" or similar. This will then show you what is not synced, and why. If you believe that your sync error is occurring due to a cloud or local item/world mismatch, you should make a choice based on how old/new/important the unsynced item is. Based on this choice you will need to use one of these two different command line arguments:

  • -DeleteUnsyncedCloudRecords will delete any local(to your computer) un-synced files/items from your computer and re-download the cloud copies. Only use this command if you are certain you will not lose important files/items when they are deleted from your computer.
  • -ForceSyncConflictingCloudRecords will force the conflicting local files/items to be uploaded to the cloud. This will overwrite the existing cloud files/items with your local copies. This can overwrite your cloud data with an earlier/incorrect version, so use it carefully.

To enter these command line arguments in the Steam build:

  1. Right click on Neos VR in your library
  2. Select Properties and then Set Launch Options.
  3. Enter the command exactly as it appears above and Run Neos.
  4. Wait for everything to load as per normal, Look for a Green Sync status in your Neos Dash.
  5. Exit Neos.
  6. Remove the command line argument you previously added so it doesn’t apply on subsequent launches.

To enter them in the standalone build, follow this tutorial by ProbablePrime.


If you believe that the syncing issue is caused by something else (for example, you see a "Too many requests" error in your log, or an "out of space" error), please ask the #❓questions-help channel in the Neos Discord for further assistance. Please include in your message what error you are getting, and the log file itself.

If you have any other questions or issues please ask in the #❓questions-help channel of the Neos Discord.

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.

My database is frequently corrupting/my primary drive is out of space.

By default, Neos stores all of its temporarily cached assets inside of the Temp folder of the user's Windows account. To access it, you can press Windows Key + R, enter `%TEMP%\Solirax\NeosVR` then OK and delete the cache folder to reset it. This is only recommended if you are low or out of space, as it will require that you re-download assets for worlds you visit.

Smarter cache management is planned, but for now, if you wish to relocate the cache to a larger secondary drive, you may do so using the `-CachePath <file path>` command line argument as listed on the wiki: Command Line Arguments#Misc

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.