Skip to content

mrachinskiy/jewelcraft

Repository files navigation

JewelCraft—jewelry design toolkit add-on for Blender.

Features:

  • Create and customize gems, prongs and cutters. [▸]
  • Organize library of components using in add-on asset manager. [▸]
  • Manage distances between gems to create compact setting. [▸]
  • Calculate weight in a variety of precious alloys.
  • Generate color-coded gem map. [▸]
  • Present summary information about your design. [▸]
  • Translated to multiple languages:
    • 100% English
    • 100% Russian
    • 93% Simplified Chinese
    • 93% Traditional Chinese
    • 89% Spanish
    • 85% Arabic
    • 74% Italian
    • 66% French
    • Your language is missing or incomplete? Contribute translation.

How to install

For Blender 4.2 or newer

Or download and drag zip file into Blender1


For Blender 4.1 or older

  1. Download JewelCraft 2.17.21
  2. Make sure you have Blender 3.5 or newer.
  3. Open PreferencesAdd-ons category.
  4. Use Install to install add-on from downloaded zip archive.2

1 Note for mac users: Safari browser will automatically unpack downloaded zip archive, to prevent that go SafariPreferencesGeneral and uncheck Open "safe" files after downloading option.

2 If error occurs on add-on activation, it means you are trying to install add-on repository instead of release. Make sure you download add-on release using link provided in step one of this guide.

Установка

Для Blender 4.2 или новее

Или скачайте и перетащите zip-файл в Blender1


Для Blender 4.1 или старше

  1. Загрузите JewelCraft 2.17.21
  2. Убедитесь, что у вас установлен Blender 3.5 или новее.
  3. Откройте PreferencesAdd-ons
  4. Воспользуйтесь Install чтобы установить аддон из загруженного архива.2

1 Примечание для пользователей mac: браузер Safari автоматически распаковывает скачиваемые zip архивы, чтобы это предотвратить в настройках SafariPreferencesGeneral отключите опцию Open "safe" files after downloading.

2 Если при активации аддона возникает ошибка, значит вы пытаетесь установить репозиторий вместо релиза. Для загрузки релиза используйте ссылку, приведённую в первом шаге данного руководства.

Contributing

Did you find a bug?

  • Ensure the bug can be reproduced in the latest add-on version.
  • Open new bug report, be sure to include Blender and add-on versions, and screenshot showing the error message.

Translations

  • It is advised that you use a dedicated .po editor like Poedit.
    • To create new transltation in Poedit use FileNew from POT/PO file, then pick .po file from add-on localization folder (doesn't matter which one).
    • To complete existing transltation in Poedit use FileOpen, then pick .po file for specific language from add-on localization folder.
  • Translating tips:
    • The UI convention for English language is to use Title Case formatting for property names and button titles, to know formatting convention for your language just see how Blender handles it and follow the rule.
    • Preserve empty braces {} in translation, they used as placeholders for additional information and will not appear in UI.
    • Look out for appropriate context, Base for example is used in the context of materials as Base Metal, which in other words means Non-Presious Metal and should not be translated as Basis or Foundation.
    • If you have limited amount of time to work on translation, then make sure to prioritize in the following order:
      • Essentials: add-on sidebar UI, gem names and cuts.
      • Good to have: tool popups and modal UI, add-on preferences, precious alloys, error messages.
      • The rest: tooltips and other UI messages.
  • After translation is done submit it back through issues.