Skip to content

Commit 27b5a74

Browse files
committed
2 parents e261cdf + f718ce4 commit 27b5a74

1 file changed

Lines changed: 54 additions & 1 deletion

File tree

README.md

Lines changed: 54 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,55 @@
11
# UdonNotifier
2-
A VRChat Notification System for your world. Includes built in support for Player Join/Leave notification and outdated instance warning.
2+
A VRChat Notification System for your world. Use this prefab for sending notification messages to players. You can use it for sending error messages, hints, tooltips, visual feedback after interacting with objects or use some of the built in features like:
3+
* Player Join/Leave notification
4+
* Outdated instance warning
5+
* Custom welcome message
6+
7+
Additionally supports:
8+
* Overriding notification sound and display time
9+
* Supports showing multiple notifications at the same time
10+
11+
![image](https://github.com/danielfvm/UdonNotifier/assets/23420640/37afeafc-1162-4cc9-a6ab-c74f3aea948e)
12+
13+
## Installation
14+
Download the prefab from releases, click on the `.unitypackage` and in Unity click on `Import`
15+
![image](https://github.com/danielfvm/UdonNotifier/assets/23420640/57282709-bd87-4bf2-8345-422ff77d4c95)
16+
17+
Finally, Drag and Drop the `Assets/UdonNotifier/NotificationManager` Prefab into your Scene.
18+
19+
## Configuration
20+
The `NotificationManager` contains following scripts that can individually be configured:
21+
* NotificationManager
22+
Here you can configure the position, size and default fade in/out sound of the notifications.
23+
Use a reference to the script to send your own custom Notifications.
24+
* Join Leave Notifier
25+
Shows notifications when a player joins or leaves your world. You can change the message format, duration and optionally you can disable seeing your own join/leave notifications. If you don't want join/leave notifications in your world, disable the Component.
26+
27+
![image](https://github.com/danielfvm/UdonNotifier/assets/23420640/d2b435f5-83d4-4eaa-8d0b-c0255331f568)
28+
29+
* Welcome Notifier
30+
Displays a custom welcome message to players joining your world. You could use it to give players a hint how to access menus, general information, plug your patreon or simply to greet them :). Disable the Component if you don't need this.
31+
32+
![image](https://github.com/danielfvm/UdonNotifier/assets/23420640/8b15c50f-2d5d-4326-b038-efc4c1ee3e19)
33+
34+
* Update Notifier
35+
Will automatically warn the player if they joined an outdated instance of your world. This can be useful if you have many active players in your world and frequently update your world, as things might get broken when players with different versions of your world join the same instance. You can change the message and display duration in the settings. Disable the Component if you don't need this. Additionally it will display a debug log message that shows the version and upload date of both the instance and your local version.
36+
37+
![image](https://github.com/danielfvm/UdonNotifier/assets/23420640/af8b40af-605e-4f3b-aadb-67a5940e9865)
38+
39+
## Custom Messages
40+
Sending a custom notification from UdonSharp is as easy as:
41+
```cs
42+
using DeanCode;
43+
44+
// Reference to the NotificationManager GameObject
45+
[SerializeField] NotificationManager manager;
46+
47+
void Start()
48+
{
49+
// Send a `Hello World!` Notification with a warning symbol for 10 seconds
50+
manager.SendNotification("Hello World!", NotificationType.Warning, 10);
51+
}
52+
```
53+
54+
## Credits
55+
Crediting this prefab is not required, but if you do it is very appreciated <3

0 commit comments

Comments
 (0)