React Three Rapier - Unified Package

Ce package unifié combine @react-three/rapier et @react-three/rapier-addons en un seul package facile à utiliser.

📦 Installation locale

$3

``bash


Dans le dossier unified

npm install
npm run build
npm link

Dans votre projet

npm link react-three-rapier-unified
`

$3

Dans votre projet, ajoutez dans package.json:

`json
{
"dependencies": {
"react-three-rapier-unified": "file:../chemin/vers/react-three-rapier/unified"
}
}
`

Puis installez:

`bash
npm install
`

$3

`bash


Depuis votre projet


cp -r /chemin/vers/react-three-rapier/unified node_modules/react-three-rapier-unified
`

🚀 Utilisation

Ce package exporte tous les composants, hooks et utilitaires des deux packages originaux:

`tsx
import {
// Composants principaux
Physics,
RigidBody,
MeshCollider,
InstancedRigidBodies,

// Colliders
BallCollider,
CuboidCollider,
CapsuleCollider,

// Hooks
useRapier,
useBeforePhysicsStep,
useAfterPhysicsStep,

// Addons
Attractor,
AttractorDebugHelper,

// Utils
interactionGroups,
createWorldFromObject3D
} from 'react-three-rapier-unified';

function App() {
return (









{/ Utiliser les addons directement /}
range={10}
strength={1}
position={[0, 5, 0]}
/>


);
}
`

📚 Contenu du package

$3


- Physics - Le conteneur de physique principal
- RigidBody - Corps rigides
- InstancedRigidBodies - Corps rigides instanciés
- MeshCollider - Collider basé sur mesh
- Tous les colliders: BallCollider, CuboidCollider, CapsuleCollider, etc.

$3

- useRapier - Accès au contexte Rapier
- useBeforePhysicsStep / useAfterPhysicsStep - Callbacks de simulation
- useFilterContactPair / useFilterIntersectionPair - Filtres de collision
- Hooks de joints: useFixedJoint, useSphericalJoint, etc.

$3

- Attractor - Composant d'attraction de corps rigides
- AttractorDebugHelper - Helper de debug pour l'attractor

$3

- interactionGroups - Gestion des groupes d'interaction
- createWorldFromObject3D - Helpers pour Three.js

🏗️ Développement

`bash


Installer les dépendances

npm install

Build du package

npm run build

Mode watch pour développement

npm run dev
`

📝 Structure du projet

`
unified/
├── src/
│ ├── components/ # Tous les composants
│ ├── hooks/ # Tous les hooks
│ ├── utils/ # Utilitaires
│ ├── addons/ # Addons (Attractor, etc.)
│ ├── types.ts # Définitions de types
│ └── index.ts # Point d'entrée principal
├── dist/ # Fichiers buildés
├── package.json
├── tsconfig.json
└── vite.config.ts
``

🔧 Configuration TypeScript

Le package est entièrement typé avec TypeScript. Les définitions de types sont incluses dans le build.

📄 Licence

MIT - Voir le fichier LICENSE pour plus de détails.

🙏 Crédits

Ce package unifie le travail original de:
- @react-three/rapier
- @react-three/rapier-addons

Créé par Hugo Wiledal et la communauté Poimandres.