================================================================================
  PalaceChat 5.0.273.2 Beta — Arch Linux installation
================================================================================

Hi, thanks for testing PalaceChat on Arch / Manjaro / EndeavourOS / Garuda /
CachyOS or any other Arch derivative.

INSTALL
-------

1. Make sure all 4 files are in the same folder:
     - palacechat-5.0.273.2.tar.gz
     - PKGBUILD
     - palacechat.install
     - install.sh

   (If you got this README in a .zip, extract it first. The files
   must stay together — makepkg verifies the sha256 of the .tar.gz
   against the PKGBUILD.)

2. Open a terminal in that folder and run:

     ./install.sh

   That's it. install.sh copies the files to ~/palacechat-build/
   (so makepkg can run even from a shared/USB folder) and then runs
   makepkg -si automatically. It will:
     - Verify the .tar.gz checksum
     - Build the package (.pkg.tar.zst)
     - Ask for your password so pacman can install it
     - Pull every dependency automatically (gtk3, webkit2gtk-4.1,
       gstreamer codecs, speech-dispatcher, bind)

   If you prefer to do it by hand, you can also just run `makepkg -si`
   directly in the folder with the 4 files.

3. When it finishes, look for "PalaceChat" in your application menu,
   or launch it from a terminal:

     palacechat


RUNNING IT WITHOUT INSTALLING
-----------------------------

If you unpack the .tar.gz and run it in place instead of installing,
start it with the launcher, NOT with the binary:

     ./palacechat.sh          <-- yes
     ./PalaceChat             <-- no

Both start and look identical, so this is easy to get wrong. The
difference shows up much later: on Linux, loading a library by its bare
name does not look in the program's own folder, only in the system
paths. The launcher points it at the right place first. Without it,
PalaceChat runs fine until it meets an animated WebP prop, and then
stops with "Could not load ... from WebPBridge.so".

Installing with install.sh or makepkg avoids this entirely: the package
puts /usr/bin/palacechat there as the launcher.


FIRST LAUNCH
------------

- If it asks for a nick / palace, try:    welcome.elitepalaces.com:7777
- Prefs are stored in:                    ~/.config/PalaceChat 5/
- Logs / props / chat archive:            ~/.local/share/PalaceChat/


UPGRADING FROM A PREVIOUS BUILD
-------------------------------

If you already had PalaceChat installed, we recommend backing up
your prop collection before installing the new build. Run:

  cp ~/.local/share/PalaceChat/PropBag.bundle \
     ~/.local/share/PalaceChat/PropBag.bundle.bak

That way if anything goes wrong with the upgrade you can restore
your saved props by reversing the copy.


LICENSE
-------

The full license terms (free for personal and commercial use, no
modification or redistribution of modified versions, 16+ age
requirement) are installed to:

  /usr/share/licenses/palacechat/copyright


REPORT BUGS
-----------

In-app:    Help > Report a Bug
Email:     alexandra@elitepalaces.com   (PalaceChat 5 dev team)


UNINSTALL
---------

  sudo pacman -Rns palacechat


Thanks for the help testing this build!
The PalaceChat 5 dev team
