-
Notifications
You must be signed in to change notification settings - Fork 0
FAQ
Quick answers to common questions about L.O.R.E.
WordPress 5.5 or higher. Most hosts run a recent version by default.
PHP 7.4 or higher. Check your hosting control panel or ask your host.
Yes! L.O.R.E. works with any OpenSim version that has a Robust database with a regions table. This includes OpenSim 0.9.x and later.
Yes, your grid needs Warp3D enabled for map tiles to appear. Most modern grids have this enabled by default. Check your OpenSim.ini for [Warp3DImageModule].
Yes, but you'll need to configure L.O.R.E. to connect to your standalone database instead of a Robust database. The table structure is the same.
No! L.O.R.E. only reads from your OpenSim database. It never writes, updates, or deletes anything. All region data is copied to a separate WordPress table (wp_lore_regions).
Only SELECT permission on the regions table. We strongly recommend creating a read-only database user for L.O.R.E.
If you create a read-only user (recommended), yes. That user can only view data, not modify it. Never give L.O.R.E. a user with UPDATE, DELETE, or DROP permissions.
In your WordPress database, in the wp_options table. They're as secure as your WordPress installation.
Not yet, but v1.1.0 will support multiple databases for large grids that shard their regions across multiple database servers. Coming soon!
Yes! Go to Settings → L.O.R.E. Map → Appearance section. Use the color pickers to set your accent and button colors.
Yes! Use multiple [lore_map] shortcodes with different parameters. Each creates an independent map instance.
Not currently. L.O.R.E. shows all regions from your database. If you need this feature, request it in GitHub Discussions.
Go to Settings → L.O.R.E. Map → Default Zoom (1-8). Or use the shortcode parameter: [lore_map zoom="5"]
Yes! The map is fully interactive. Visitors can zoom with the +/- buttons or mouse wheel, and pan by clicking and dragging.
- Active grids (adding/removing regions often): Enable auto-sync for daily updates
- Stable grids (few changes): Manual sync when needed
- Testing/development grids: Sync after each change
No. L.O.R.E. only reads from your database, and batch sync processes just 50 regions at a time. Your grid won't notice any performance impact.
They'll disappear from the map after the next sync. L.O.R.E. clears the WordPress table and re-imports fresh data on each sync.
Currently syncs run at 3:00 AM. Custom scheduling will be added in a future update. Track this in GitHub Issues.
For most grids:
- 100 regions: ~4 seconds
- 500 regions: ~20 seconds
- 1000 regions: ~40 seconds
Time varies based on database server speed and network latency.
Make sure:
- Your Grid URL is set correctly in settings (without
http://) - Your viewer is configured to handle
hop://protocol links - Your browser allows protocol handlers
See Troubleshooting for detailed solutions.
Currently all teleports land at 128, 128, 25 (center of region). Custom landing points may be added in a future version.
Only if you have a mobile OpenSim viewer installed that handles hop:// links. Most mobile browsers won't support this.
The popup design is set by L.O.R.E.'s CSS, but you can override it with custom CSS in your WordPress theme. Advanced users can edit lore.css directly (not recommended - changes will be lost on updates).
Not built-in, but you can add an image above/below the map using standard WordPress blocks or HTML.
L.O.R.E. is translation-ready but doesn't include translations yet. If you'd like to contribute a translation, see Contributing.
Currently you can choose from 4 built-in styles (none, pulse, star, pin). Custom icon support may be added in the future.
No. L.O.R.E. only loads JavaScript on pages that contain the [lore_map] shortcode. Other pages are unaffected.
Minimal. Each region takes about 200 bytes. A 500-region grid uses roughly 100 KB of database space.
Yes, but you may need to clear cache after changing settings or syncing regions. See Troubleshooting - Plugin Conflicts.
L.O.R.E. advantages:
- Modern Leaflet.js engine (vs old table-based layout)
- Live region search
- Color customization
- Batch sync with progress bar
- Auto-sync scheduling
- Active development
Yes! Just install L.O.R.E., sync your regions, and replace the old shortcode with [lore_map]. You can keep both plugins active during testing if needed.
L.O.R.E. is a standalone plugin and doesn't require w4os, but they work fine together if you use both.
Update them in Settings → L.O.R.E. Map. Auto-sync will resume working once credentials are correct again.
Yes! Just make sure:
- MySQL port 3306 is open on your database server
- Database allows remote connections (check
bind-addressin MySQL config) - You've granted access to the remote user
Only Leaflet.js from unpkg.com CDN. No tracking, no analytics, no phone-home. Your map data stays on your server.
Not yet, but custom hooks/filters may be added in future versions. If you need specific hooks, request them in GitHub Discussions.
Yes! L.O.R.E. is 100% free and open source (GPL v2).
Yes! The GPL v2 license allows commercial use.
Yes! You can modify the code for your own use. If you make improvements, consider contributing them back via pull request.
Not required, but appreciated! The map includes a small "L.O.R.E." attribution by default.
- Report bugs via GitHub Issues
- Suggest features in Discussions
- Submit pull requests with improvements
- Help improve documentation (edit any Wiki page!)
- Share L.O.R.E. with other grid owners
Check GitHub Issues to see if it's already reported. If not, create a new issue with details.
Post in GitHub Discussions under "Ideas" category.
Didn't find your question?
- Check Troubleshooting for technical issues
- Read the Configuration Guide for settings help
- Ask in GitHub Discussions
- Search existing Issues
Have a question to add to this FAQ? Edit this page or suggest it in Discussions! 🙌