multi-user/README.md

68 lines
2.4 KiB
Markdown
Raw Normal View History

2019-10-01 02:47:03 +08:00
# MULTI-USER for blender
2019-09-26 22:13:50 +08:00
> Enable real-time collaborative workflow inside blender
2019-09-26 23:16:19 +08:00
:warning: Under development, use it at your own risks. Currently tested on Windows platform. :warning:
This tool aims to allow multiple users to work on the same scene over the network. Based on a Clients / Server architecture, the data-oriented replication schema replicate blender datablocks across the wire.
2019-09-26 22:13:50 +08:00
## Installation
2019-10-22 20:08:28 +08:00
1. Download lastest release [multi_user.zip](/uploads/2cdd8e3e7082062b834b33175b81376f/multi_user.zip).
2. Install last_version.zip from your addon preferences.
[Dependencies](#dependencies) will be automatically added to your blender python during installation.
2019-09-26 22:13:50 +08:00
## Usage
2019-10-01 04:05:52 +08:00
See [how to](https://gitlab.com/slumber/multi-user/wikis/User/Quickstart) section.
2019-09-26 22:13:50 +08:00
## Current development statut
2019-10-01 17:13:43 +08:00
Currently, not all datablock are supported for replication over the wire. The following list summarizes the status for each ones.
2019-09-26 22:13:50 +08:00
2019-09-26 23:16:19 +08:00
| Name | Statut | Comment |
| ---------- | :----------------: | :--------: |
| action | :x: | WIP |
| armature | :x: | WIP |
| camera | :white_check_mark: | |
| collection | :white_check_mark: | |
| curve | :white_check_mark: | Not tested |
| gpencil | :white_check_mark: | |
2019-10-01 05:59:53 +08:00
| image | :exclamation: | Not stable yet |
2019-09-26 23:16:19 +08:00
| mesh | :white_check_mark: | |
| material | :white_check_mark: | |
| metaball | :x: | |
| object | :white_check_mark: | |
| scene | :white_check_mark: | |
| world | :white_check_mark: | |
### Performance issues
Since this addon is writen in pure python for a prototyping purpose, perfomance could be better from all perspective. Soon I will start to port the multi-user addon concept to a blender branch.
2019-09-26 22:00:26 +08:00
2019-01-24 18:49:44 +08:00
## Dependencies
2019-07-01 22:03:40 +08:00
| Dependencies | Version | Needed |
2019-09-26 22:00:26 +08:00
| ------------ | :-----: | -----: |
2019-07-01 22:03:40 +08:00
| ZeroMQ | latest | yes |
2019-09-26 22:00:26 +08:00
| msgpack | latest | yes |
2019-07-01 22:03:40 +08:00
| PyYAML | latest | yes |
2019-10-01 02:49:30 +08:00
| JsonDiff | latest | yes |
2019-08-12 21:29:16 +08:00
2019-09-26 22:00:26 +08:00
2019-08-12 21:29:16 +08:00
## Contributing
1. Fork it (<https://gitlab.com/yourname/yourproject/fork>)
2. Create your feature branch (`git checkout -b feature/fooBar`)
3. Commit your changes (`git commit -am 'Add some fooBar'`)
4. Push to the branch (`git push origin feature/fooBar`)
2019-09-26 23:16:19 +08:00
5. Create a new Pull Request
2019-10-01 02:47:03 +08:00
## Licencing
2019-10-01 02:48:07 +08:00
See [licence](LICENSE)
2019-10-01 02:47:03 +08:00