Merge upstream/dev with improved storage and DB support

- Unified clean-world script with abstraction for local/S3 storage
- Added flexible DB configuration (SQLite/PostgreSQL)
- Resolved conflicts maintaining storage and DB enhancements
- Eliminated code duplication in clean-world scripts
- Updated avatar and world systems from upstream

Author: DevStarlight

CHANGELOG.md

@@ -13,6 +13,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Fixed
 
+## [v0.14.0]
+
+### Added
+- core: ambient occlusion
+- core: new scene app format
+- core: touch device joystick UI
+- core: new camera-facing character controls
+- core: first-person support
+- apps: ability to read/write browser url params
+- apps: ability to make avatar nodes invisible (.visible)
+
+### Changed
+- core: apps list updates when others add/remove apps
+- core: reduced reticle size
+- core: fog is now radial distance based
+- core: don't preload apps that are disabled
+- core: sleeker sidebar UI
+
+### Fixed
+- core: shift clicking file fields to download
+- core: fix weird transparency ordering issues
+- core: improve touch device chat UX
+
 ## [v0.13.0]
 
 ### Added
@@ -413,7 +436,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Basic project structure
 - Core functionality from original project
 
-[Unreleased]: https://github.com/hyperfy-xyz/hyperfy/compare/v0.13.0...HEAD
+[Unreleased]: https://github.com/hyperfy-xyz/hyperfy/compare/v0.14.0...HEAD
+[0.14.0]: https://github.com/hyperfy-xyz/hyperfy/compare/v0.13.0...v0.14.0
 [0.13.0]: https://github.com/hyperfy-xyz/hyperfy/compare/v0.12.0...v0.13.0
 [0.12.0]: https://github.com/hyperfy-xyz/hyperfy/compare/v0.11.0...v0.12.0
 [0.11.0]: https://github.com/hyperfy-xyz/hyperfy/compare/v0.10.0...v0.11.0

README.md

@@ -21,6 +21,8 @@ Hyperfy is an open-source framework for building interactive 3D virtual worlds.
 - **WebXR support** - Experience worlds in VR
 - **Extensible architecture** - Highly customizable for various use cases
 
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/hyperfy-xyz/hyperfy)
+
 ## 🚀 Quick Start
 
 ### Prerequisites
@@ -59,7 +61,7 @@ For containerized deployment, check [DOCKER.md](DOCKER.md) for detailed instruct
 
 ## 📚 Documentation & Resources
 
-- **[Community Documentation](https://hyperfy.how)** - Comprehensive guides and reference
+- **[Community Documentation](https://docs.hyperfy.xyz)** - Comprehensive guides and reference
 - **[Website](https://hyperfy.io/)** - Official Hyperfy website
 - **[Sandbox](https://play.hyperfy.xyz/)** - Try Hyperfy in your browser
 - **[Twitter/X](https://x.com/hyperfy_io)** - Latest updates and announcements

docs/ref/Avatar.md

@@ -19,6 +19,10 @@ An asset url (eg from props) or an absolute URL to a `.vrm` file.
 
 An emote url (eg from props) or an absolute URL to a `.glb` file with an emote animation.
 
+### `.visible`: Boolean
+
+Whether the avatar is visible or not. 
+
 ## Methods
 
 ### `.getHeight()`: Number

docs/ref/World.md

@@ -54,3 +54,11 @@ Returns a player. If no `playerId` is provided it returns the local player.
 
 Returns an array of all players.
 
+### `.getQueryParam(key)`
+
+Gets a query parameter value from the browsers url
+
+### `.setQueryParam(key, value)`
+
+Sets a query parameter in the browsers url
+

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "hyperfy",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "type": "module",
   "main": "index.js",
   "homepage": "https://github.com/hyperfy-xyz/hyperfy#readme",
@@ -59,6 +59,7 @@
     "lucide-react": "^0.469.0",
     "moment": "^2.30.1",
     "msgpackr": "^1.11.0",
+    "n8ao": "^1.10.0",
     "nanoid": "^5.0.6",
     "postprocessing": "^6.36.4",
     "react": "^19.1.0",
@@ -72,8 +73,7 @@
   "optionalDependencies": {
     "pg": "^8.16.0",
     "@aws-sdk/client-s3": "^3.685.0",
-    "@aws-sdk/s3-request-presigner": "^3.685.0",
-    "pg": "^8.16.0"
+    "@aws-sdk/s3-request-presigner": "^3.685.0"
   },
   "devDependencies": {
     "@babel/eslint-parser": "^7.23.10",