- Robust server must be installed before setting up W4OS.
- To allow users to choose an avatar on registration, you must enable user
profiles in Robust.ini (update [UserProfilesService], [ServiceList] and
- You should have a working assets server (see Dependencies section below)
- Download and activate the latest stable release
- Visit OpenSim settings (admin menu > “Opensim” > “Settings”)
- Enter your grid name and grid URI (like example.org:8002 without http://)
- Enter your robust database connection details and submit. If you get a
database connection error, it might come from a case-sensitivity issue (see
[gridstatus] shortcodes in a page or in a sidebar widget
- Set permalinks and profile page
- Visit Settings > Permalinks, confirm W4OS slugs (profile and assets) and save.
- Create a page with the same slug as Profile permalink.
(This will be handled in a more convenient way in the future)
Create avatar models
Avatar models are displayed on new avatar registration and allow new users to start with another appearance than Ruth.
The model will now appear in new avatar registration form, with its profile picture.
These accounts will be excluded from grid statistics.
Web Asset Server: the project requires a web asset server to convert simulator assets (profile pictures, model avatars…) and display them on the website. W4OS provides a web assets service, or you can specify an external web assets service URL instead.
PHP Modules: while they are not required, WordPress recommends activating PHP curl and xml modules. They are also recommended by W4OS for full functionalties.
See (https://github.com/GuduleLapointe/w4os/projects/1) for up-to-date status.
Short term (v2.2)
- [x] Include web asset server
- [x] Add avatar picture to gridprofile output
- [x] Sidebar grid info and grid status widgets.
- [x] Use avatar profile pic as WP avatar
- [x] Show avatar picture in user lists
- [x] Login page / Widget
- [x] Option to show avatar name instead of real name in user lists
- [x] Manual Grid and WP users sync
- [x] Cron Grid and WP users sync
- [x] Public avatar profile
- [x] Auth with avatar credentials (if no matching wp account, create one)
- [x] get grid info from http://login.uri:8002/get_grid_info
- [x] Web Assets server
- Improve avatar profile
- Switch to allow public profile
- Better basic layout
- Web edit profile
- Admin Start / Stop regions
- Admin Create region
- Admin Use sim/grid configuration file to fetch settings if on the same host
- Helpers (search, currency, map…)
- Admin create users
- Admin create models (from current appearance)
- Deactivate (recommended) or delete (experimental) grid user when deleting wp account
- Choice between Robust console or database connection
- User’s own regions control (create, start, stop, backup)
- WooCommerce Subscriptions integration for user-owned Regions or other pay-for services
Do I need to run the website on the same server?
No, if your web server has access to your OpenSimulator database.
Can I use this plugin for my standalone simulator?
Yes, it works too. Use OpenSim database credentials when requested for Robust credentials.
Why can’t I change my avatar name?
This is an OpenSimulator design limitation. Regions rely on cached data to display avatar information, and once fetched, these are never updated. As a result, if an avatar’s name (or grid URI btw) is changed, the change will not be reflected on regions already visited by this avatar (which will still show the old name), but new visited region will display the new one. This could be somewhat handled for a small standalone grid, but never in hypergrid context. There is no process to force a foreign grid to update its cache, and probably never will.