Project Introduction (English) | 한글
- This project is an open-source project called XRCLOUD, which was developed by forking the Hubs project from BELIVVR. The goal was to develop additional features and provide resources of Hubs Rooms and Scenes as a membership-based cloud service.
- As of February 2025, BELIVVR has decided not to continue further development due to business challenges and has released it as open source.
- This is a detailed documentation service for partners who have been provided with development services, and it aims to contribute to the web metaverse open-source ecosystem, albeit in a small way.
- Please note that we did not have the capacity to send separate PRs to HubsFoundation, and the XRCLOUD service has secured servers that can be operated until September 2025, but there are no confirmed plans for the service thereafter. Technical support will be provided to partners who have been promised service until December 2025.
- For further inquiries, please contact the former CEO of BELIVVR, Byungseok Yang (fstory97@gmail.com).
- This project has dependencies on multiple subRepository projects. The XRCLOUD project follows the same license, and projects forked from hubsFoundation follow the licenses of their original projects.
- For detailed installation and operation methods, please refer to the Installation and Operation Guide.
- Subprojects including hubs follow the licenses of their original projects.
- XRCLOUD follows the Apache License 2.0.
- Patent Notice:
- The use of this software does not grant any rights to BELIVVR's patents.
- While this software is released under the Apache 2.0 License, this license does not provide complete immunity from patent claims.
- BELIVVR holds several patents related to certain functionalities within this system.
- Separate patent licenses may be required for commercial use of features covered by these patents.
- For patent licensing inquiries, please contact: fstory97@gmail.com
- For complete license and patent information, please refer to the LICENSE and NOTICE files.
- XRCLOUD-BACKEND: Nest.js, Node.js, PostgreSQL, Docker, REDIS
- XRCLOUD-FRONTEND: Next.js, React, TypeScript, Docker
- XRCLOUD is a fork project of hubs and provides the basic features of hubs. It does not use the admin project of hubs, allowing various users to use one admin account of hubs through XRCLOUD, managing the resources of hubs through XRCLOUD.
- It is possible to set different levels for 3rd party developers and provide differentiated services through subscription management.
- The XRCLOUD project aimed to expand the features of hubs to provide differentiated features and a membership-based cloud service.
- It is possible to limit the number of entries in a room and the number of scenes and rooms that can be created.
- A separate management tool was not developed, and upon registration, users are set to the default Tier, and upgrades to additional Tiers must be done in the database.
- Storage limitations and payment-related features are not implemented.
- Provides a dashboard service for managing members, projects, scene management corresponding to the web editor of the metaverse space, and room management corresponding to the metaverse space instance for 3rd party developers.
- Provides APIs for managing projects, scenes, and rooms for 3rd party developers. For API details, please refer to the XRCLOUD API Documentation.
- Provides APIs related to 3rd party members, allowing the creation of a creative platform through separate user management on the 3rd party developer's platform.
- It is possible to give differentiated permissions by dividing host and guest users.
- It is possible to generate expiring private URLs and continuously public URLs.
- It is possible to display the managed Medium blog within the service.
- Added room logging and event hook features to XRCLOUD's custom hubs (hubs-all-in-one).
- Room Logging: Logs events such as room entry, exit, and movement.
- Event Hooks: Hooks events such as room entry, exit, and movement to deliver them externally.
- It is possible to set a hook URL per project.
- Supports BELIVVR's open-source full-body avatar editor.
- This avatar project is not designed considering Bit-ecs, so it does not support all features of Hubs.
- Pressing the J key in desktop mode makes the avatar jump.
- Note: The full-body avatar resets the y-value to the ground when jumping, so it cannot jump.
- Supports third-person view in desktop mode, with the camera positioned behind the avatar and adjustable camera position. When moving, the camera rotates behind the avatar's head to match the avatar's perspective.
- There is a somewhat unnatural aspect due to the roll operation in the third-person free view. This part was not improved due to time constraints.
- It is possible to change the avatar through URL query parameters.
- Allows immediate entry by skipping the device and avatar setting modal window.
# Avatar Setting & fastEntry use example
https://room.xrcloud.app:4000/qkoCp3x/test2?public=04f740f3-b96f-43da-90da-5c99d64e2364%
avatarUrl=https://belivvr.github.io/files/Avatars/VVRI_SD_Ani_Ribbon_ReAnimaion_04.glb&
&displayName=VVRI
&funcs=fastEntry
-
A component similar to the link component but with enhanced features.
-
iframe-based content view: A custom Spoke component by BELIVVR that can display content in the 3D main view of Hubs, chat sidebar, its own window, or a new window.
-
XRCLOUD's privateURL can pre-deliver data when generating the URL, allowing different content to be displayed for each user.
-
-
Button Text Customization: Unlike the link component, users can modify the button text.
-
Avatar Change Feature: It is possible to include avatar settings in the target URL and change them upon click.
- When used with the mirror component of Spoke, it is possible to implement features such as an avatar shop.
-
Proximity Trigger: Automatically activates within a specified distance.
- When used with the avatar change feature, it is possible to enforce the use of a specific avatar in a specific room.
-
Room Transition Without Refresh: Supports room transitions without refresh, similar to the link component.
- When used with the proximity trigger, it is possible to implement a natural portal transition feature that moves to another room at a specific location.
- For detailed pages on applied cases, please refer to Applied Cases.
- CNU Metaversity (Chonnam National University Metaverse): A virtual campus developed since 2022, offering student creation features, personal spaces using template rooms, metaverse creation competitions, and metaverse graduation and entrance ceremonies. This project received the most help in its development.
- Meta Track: A metaverse education platform completed in 2024, allowing teachers to create classes and register metaverse classes and attendance by matching with subject-specific metaverse spaces created by administrators.
- ClassV: A metaverse education program operation platform developed by BELIVVR, allowing class creation and sharing of student-created content.
- Suncheon Eco Net: A metaverse platform for Suncheon city, showcasing the ecological environment of Suncheon Bay and providing materials for children's environmental education programs using the metaverse.
- For space (Scene/Spoke) data available according to CCL, please refer to Space Resources.
- For additional technical inquiries, please contact the former CEO of BELIVVR, Luke Yang (fstory97@gmail.com).